VEO Video Generation — Query Task Status and Result

After you create a VEO video generation task, use this endpoint to check its status and retrieve the download URL once generation is complete. Pass the id returned by the Create Video Task endpoint as the path parameter, and keep polling until status is "completed" or "failed".

VEO video generation is asynchronous. All output videos have a fixed duration of 8 seconds, regardless of the model or input parameters used.

Endpoint

Base URL:  https://zcbservice.aizfw.cn/kyyReactApiServer
Endpoint:  GET /v1/result/{id}
Full URL:  https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/{id}

All requests must include your API key as a Bearer token:

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

The unique task identifier returned by the Create Video Task endpoint (e.g. vgen_abc123def456).

Response Fields

string

Unique identifier of the video generation task.

string

Object type. Always "video".

integer

Unix timestamp (seconds) of when the task was created.

string

The VEO model used for generation (e.g. "veo_3_1_fast").

string

Current task status:

queued — task is in the queue, waiting to be processed
processing — the VEO model is actively generating the video
completed — generation succeeded; video_url is populated
failed — generation failed; see error for details

string

A direct download URL for the generated MP4 video. Only present when status is "completed". The URL is valid for 24 hours — download and store the video before it expires.

number

The actual output duration of the video in seconds. VEO always produces 8-second videos. Only present when status is "completed".

string

Error message describing why the task failed. Only present when status is "failed".

Status Flow

Step	Status	Meaning
1	`queued`	Task created and added to the processing queue
2	`processing`	VEO model is generating the video
3	`completed`	Video is ready; retrieve it via `video_url`
—	`failed`	An error occurred; inspect the `error` field

Polling Recommendations

Poll every 30–60 seconds. VEO generation is relatively fast, but still takes several minutes.

Stop polling as soon as status is "completed" or "failed".
Avoid polling more frequently than every 30 seconds to prevent rate limiting.

Generation Time Estimates

Generation Mode	Estimated Time
Reference image mode	~2–5 minutes
First/last frame mode	~3–5 minutes

Video URL Notes

The video_url is valid for 24 hours after the task completes. Download and save the file to your own storage promptly — the URL cannot be recovered after expiry.

Format: MP4
Duration: fixed 8 seconds

Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/vgen_abc123def456 \
  --header 'Authorization: Bearer YOUR_API_KEY'

import time
import requests

BASE_URL = "https://zcbservice.aizfw.cn/kyyReactApiServer"
API_KEY = "YOUR_API_KEY"
TASK_ID = "vgen_abc123def456"

headers = {"Authorization": f"Bearer {API_KEY}"}

while True:
    response = requests.get(
        f"{BASE_URL}/v1/result/{TASK_ID}",
        headers=headers,
    )
    data = response.json()
    status = data["status"]
    print(f"Status: {status}")

    if status == "completed":
        print(f"Video URL: {data['video_url']}")
        print(f"Duration: {data.get('actualDuration')}s")
        break
    elif status == "failed":
        print(f"Generation failed: {data.get('error')}")
        break

    # Poll every 30 seconds
    time.sleep(30)

Example response — processing:

{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "processing",
  "video_url": null,
  "error": null
}

Example response — completed:

{
  "id": "vgen_abc123def456",
  "object": "video",
  "created": 1761635478,
  "model": "veo_3_1_fast",
  "status": "completed",
  "video_url": "https://cdn.example.com/videos/vgen_abc123def456.mp4",
  "actualDuration": 8,
  "error": null
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

VEO Video Generation — Query Task Status and Result

Endpoint

Path Parameters

Response Fields

Status Flow

Polling Recommendations

Generation Time Estimates

Video URL Notes

Code Examples

​Endpoint

​Path Parameters

​Response Fields

​Status Flow

​Polling Recommendations

​Generation Time Estimates

​Video URL Notes

​Code Examples

Endpoint

Path Parameters

Response Fields

Status Flow

Polling Recommendations

Generation Time Estimates

Video URL Notes

Code Examples