Videos API: Query Video Generation Task Status and Result

Use this endpoint to poll the status of a Videos model video generation task and retrieve the output URL once complete. Video generation is asynchronous — after submitting a task via Create Video Task, call this endpoint periodically until status reaches completed or failed.

Endpoint

GET /v1/result/{id}

Authentication

Authorization: Bearer YOUR_API_KEY

Path Parameters

string

required

The unique task identifier returned by the Create Video Task endpoint. Use the exact value of the id field from the creation response.

Response Fields

string

The unique task identifier.

string

Object type. Always "video".

integer

Unix timestamp of when the task was created.

string

The model used for this task (e.g., videos or videos_fast).

string

Current task status:

queued — task is waiting in the processing queue
processing — the model is actively generating the video
completed — generation finished; video_url is populated
failed — generation failed; see error for details

string

Temporary download URL for the generated video. Only present when status is "completed". null while the task is pending or processing.

number

Actual output duration of the generated video in seconds. Only present when status is "completed".

string

Error message describing the failure reason. Only present when status is "failed".

Task Status Flow

queued → processing → completed or failed

Status	Meaning
`queued`	Task accepted, waiting to be processed
`processing`	Videos model is actively generating the video
`completed`	Video ready — retrieve via `video_url`
`failed`	An error occurred — check `error` for details

Polling Advice

Recommended polling interval: 30–60 seconds.Most tasks complete within a few minutes. Tasks using multiple reference images or videos may take longer due to additional processing. Stop polling as soon as status is completed or failed — excessive polling may trigger rate limiting.

Result URL Notes

The video_url is a temporary download link. Save the video to your own storage immediately after generation completes — the URL will expire and become inaccessible.

Tasks that fail content policy checks will return status: "failed" immediately
Tasks with heavier reference media (more images, longer videos) will take longer to complete

Code Examples

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

import requests
import time

task_id = "video_1234567890"
headers = {"Authorization": "Bearer YOUR_API_KEY"}

while True:
    response = requests.get(
        f"https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/{task_id}",
        headers=headers,
    )
    result = response.json()
    status = result["status"]

    print(f"Status: {status}")

    if status == "completed":
        print("Video URL:", result["video_url"])
        print("Actual duration:", result["actualDuration"], "seconds")
        # Download and store the video before the URL expires
        break
    elif status == "failed":
        print("Error:", result["error"])
        break

    time.sleep(30)

Example Responses

While processing:

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

On completion:

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

On failure:

{
  "id": "video_1234567890",
  "object": "video",
  "created": 1761635478,
  "model": "videos",
  "status": "failed",
  "video_url": null,
  "error": "Reference video exceeds maximum total duration of 15 seconds."
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

Videos API: Query Video Generation Task Status and Result

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Result URL Notes

Code Examples

Example Responses

​Endpoint

​Authentication

​Path Parameters

​Response Fields

​Task Status Flow

​Polling Advice

​Result URL Notes

​Code Examples

​Example Responses

Endpoint

Authentication

Path Parameters

Response Fields

Task Status Flow

Polling Advice

Result URL Notes

Code Examples

Example Responses