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
  }
}
This endpoint is the authoritative source of truth for querying the execution status and final results of all Veo 3.1 video tasks, including regular generation, video extension, 1080P upgrade, and 4K upgrade tasks.

​
Supported Task Types

This interface supports querying all Veo 3.1 task types, including:
  • Regular Video Generation
    Text-to-video, image-to-video, reference/material-based generation
  • Video Extension
    Tasks created via the Extend Veo 3.1 Video interface
  • 1080P Upgrade Tasks
    High-definition upgrade tasks created via Get 1080P Video
  • 4K Upgrade Tasks
    Ultra-high-definition upgrade tasks created via Get 4K Video

​
Status Descriptions

successFlagDescription
0Generating — task is currently being processed
1Success — task completed successfully
2Failed — task failed before completion
3Generation Failed — task created successfully but upstream generation failed

​
Important Notes

  • Query task status using taskId
  • You may poll this endpoint periodically until the task completes
  • Callback mechanisms push completion events, but this endpoint remains the final authority
  • fallbackFlag is a legacy field and may appear only in older regular generation tasks

​
Response Field Descriptions

​
fallbackFlag
boolean
Only exists in regular video generation tasks. Whether generated using fallback model. true means backup model was used, false means primary model was used. 4K video generation tasks do not include this field.
​
successFlag
integer
Task success status identifier:
  • 0: Generating
  • 1: Success
  • 2: Failed
  • 3: Generation Failed
​
response
object
Detailed result information after task completion. For regular video generation tasks, contains video URLs etc.; for 4K video generation tasks, contains 4K video URLs and related media information.

​
Task Type Identification

​
Regular Video Generation Tasks

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.

​
4K Video Generation Tasks

  • Dedicated tasks for generating 4K ultra-high-definition videos
  • Does not include fallbackFlag field
  • Generated videos are in 4K resolution
  • Response includes mediaIds and related media information

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