KIE.AI
English
  • English
  • Chinese
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Veo3.1 API
  • Veo3.1 API Quickstart
  • Veo3.1 Video Generation Callbacks
  • Get 4K Video Callbacks
  • Generate Veo3.1 Video
    POST
  • Get Veo3.1 Video Details
    GET
  • Get 1080P Video
    GET
  • Get 4K Video
    POST
  • Extend Veo3.1 Video
    POST
English
  • English
  • Chinese
Support
English
  • English
  • Chinese
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
MarketVeo3.1 API
Suno API4o Image APIFlux Kontext APIRunway APILuma APIFile Upload APICommon API
  1. Veo3.1 API

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#

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#

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

Responses

🟢200
application/json
Request successful
Body

🔴500Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '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"
            ],
            "resolution": "1080p"
        },
        "successFlag": 1,
        "errorCode": null,
        "errorMessage": "",
        "createTime": "2025-06-06 10:25:00",
        "fallbackFlag": false
    }
}
Previous
Generate Veo3.1 Video
Next
Get 1080P Video
Built with