Get Veo3 Video Details

Query the execution status and results of Veo3 video generation tasks.

GET /api/v1/veo/record-info

Get Veo3 Video Details

cURL

curl --request GET \
  --url https://api.veo3api.ai/api/v1/veo/record-info \
  --header 'Authorization: Bearer <token>'

200

{
  "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/original1.mp4"
      ],
      "resolution": "1080p"
    },
    "successFlag": 1,
    "errorCode": null,
    "errorMessage": "",
    "createTime": "2025-06-06 10:25:00",
    "fallbackFlag": false
  }
}

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

Response Fields

The response includes several important fields in the data.response object:

• resultUrls: Array of generated video URLs
• originUrls: Original video link array (only when aspectRatio is not 16:9)
• fallbackFlag: Indicates whether the video was generated using fallback model
• resolution: Video resolution (e.g., 720p, 1080p)

Important Notes

• Query task status in real-time using taskId
• Recommend periodic polling until task completion
• The resolution field indicates the actual resolution of the generated video
• For fallback videos, the resolution will be included even though they may not support the 1080P upgrade endpoint

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

200

application/json

Request successful

code · enum<integer> · required

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, or Your request was rejected by Flow(Your request was rejected by Flow.). You may consider using our other fallback channels, which are likely to succeed. Please refer to the documentation.

• 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 · required

Error message when code != 200

Example:

"success"

data · object

Show child attributes