Skip to main content
GET
/
api
/
v1
/
veo
/
record-info
Get Veo3.1 Video Details
curl --request GET \
  --url https://api.kie.ai/api/v1/veo/record-info \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "msg": "success",
  "data": {
    "taskId": "veo_task_abcdef123456",
    "paramJson": "{\"prompt\":\"A futuristic city with flying cars at sunset.\",\"waterMark\":\"KieAI\"}",
    "completeTime": "2025-06-06 10:30:00",
    "response": {
      "taskId": "veo_task_abcdef123456",
      "resultUrls": [
        "http://example.com/video1.mp4"
      ],
      "originUrls": [
        "http://example.com/original_video1.mp4"
      ],
      "resolution": "1080p"
    },
    "successFlag": 1,
    "errorCode": null,
    "errorMessage": "",
    "createTime": "2025-06-06 10:25:00",
    "fallbackFlag": false
  }
}
Query the execution status and results of Veo3.1 video generation tasks.

​
Status Descriptions

  • 0: Generating - Task is currently being processed
  • 1: Success - Task completed successfully
  • 2: Failed - Task generation failed
  • 3: Generation Failed - Task created successfully but generation failed

​
Important Notes

  • Query task status in real-time using taskId
  • Recommend periodic polling until task completion
  • Response includes fallbackFlag field indicating whether fallback model was used

​
Response Field Description

​
fallbackFlag
boolean
Whether generated using fallback model. true means backup model was used, false means primary model was used

​
Fallback Status Identification

The fallbackFlag field can identify whether the task used a fallback model:
  • true: Generated using fallback model, video resolution is 720p
  • false: Generated using primary model, may support 1080P (16:9 aspect ratio)
Videos generated using the fallback model cannot be upgraded to high-definition versions through the Get 1080P Video interface.

Authorizations

​
Authorization
string
header
required

All APIs require authentication via Bearer Token.

Get API Key:

  1. Visit API Key Management Page to get your API Key

Usage: Add to request header: Authorization: Bearer YOUR_API_KEY

Query Parameters

​
taskId
string
required

Task ID

Response

Request successful

​
code
enum<integer>

Response status code

  • 200: Success - Request has been processed successfully
  • 400: Your prompt was flagged by Website as violating content policies. Only English prompts are supported at this time. Failed to fetch the image. Kindly verify any access limits set by you or your service provider. public error unsafe image upload.
  • 401: Unauthorized - Authentication credentials are missing or invalid
  • 404: Not Found - The requested resource or endpoint does not exist
  • 422: Validation Error - The request parameters failed validation checks. record is null. Temporarily supports records within 14 days. record result data is blank. record status is not success. record result data not exist. record result data is empty.
  • 451: Failed to fetch the image. Kindly verify any access limits set by you or your service provider.
  • 455: Service Unavailable - System is currently undergoing maintenance
  • 500: Server Error - An unexpected error occurred while processing the request. Timeout Internal Error, Please try again later.
Available options:
200,
400,
401,
404,
422,
451,
455,
500
​
msg
string

Error message when code != 200

Example:

"success"

​
data
object