Get Veo3.1 Video Details

GET

/api/v1/veo/record-info

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 #

successFlag	Description
0	Generating - task is currently being processed
1	Success - task completed successfully
2	Failed - task failed before completion
3	Generation 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 #

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

Request

Authorization

Bearer Token

Provide your bearer token in the Authorization header when making requests to protected resources.

Example:

Authorization: Bearer ********************

or

Query Params

Generate Code

taskId

string

required

Task ID

Example: veo_task_abcdef123456

Responses

🟢200

application/json

Request successful

Bodyapplication/json

Generate Code

code

enum<integer>

optional

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.

Allowed values: 200400401404422451455500

msg

string

optional

Error message when code != 200

Example: success

data

object

optional

taskId

string

optional

Unique identifier of the video generation task

Example: veo_task_abcdef123456

paramJson

string

optional

Request parameters in JSON format

Example:

completeTime

number

optional

Task completion time

response

object

optional

Final result

successFlag

enum<integer>

optional

Generation status flag

0: Generating

1: Success

2: Failed

3: Generation Failed

Allowed values: 012

Example: 1

errorCode

enum<integer><int32>|enum<null>

optional

Error code when task fails

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.

500: Internal Error, Please try again later.

Internal Error - Timeout

501: Failed - Video generation task failed

Allowed values: 400500501

errorMessage

string|null

optional

Error message when task fails

Example: null

createTime

number

optional

Task creation time

fallbackFlag

boolean

deprecated

Whether generated using fallback model. True means backup model was used, false means primary model was used

Example: false

🔴500Error

Request Request Example

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

cURLcURL-WindowsHttpiewgetPowerShell

curl --location 'https://api.kie.ai/api/v1/veo/record-info?taskId=veo_task_abcdef123456' \
--header 'Authorization: Bearer <token>'

Response Response Example

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/original_video1.mp4"\
            ],
            "fullResultUrls": [\
                "http://example.com/full_result.mp4"\
            ],
            "resolution": "1080p"
        },
        "successFlag": 1,
        "errorCode": null,
        "errorMessage": "",
        "createTime": "2025-06-06 10:25:00",
        "fallbackFlag": false
    }
}