Skip to main content
GET
/
api
/
v1
/
veo
/
record-info
Get Veo3 Video Details
curl --request GET \
  --url https://api.veo3api.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/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

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