StarVideos O3: Query Video Generation Task Status and Result

Use this endpoint to poll the status of a StarVideos O3 video generation task and retrieve the output URL once generation completes. Video generation is asynchronous — submit a task via Create Video Task, then poll 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. Always "starvideos_o3".

string

Current task status:

queued — task is waiting in the processing queue
processing — StarVideos O3 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 picked up
`processing`	StarVideos O3 model is 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.Stop polling as soon as status becomes completed or failed. Polling too frequently may trigger rate limiting.

Result URL Notes

The video_url is a temporary download link. Download and save the video to your own storage immediately after the task completes — the URL will expire and become inaccessible after a short period.

Code Examples

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

import requests
import time

task_id = "video_starvideos_o3_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")
        break
    elif status == "failed":
        print("Error:", result["error"])
        break

    time.sleep(30)

Example Responses

While processing:

{
  "id": "video_starvideos_o3_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_o3",
  "status": "processing",
  "video_url": null,
  "error": null
}

On completion:

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

On failure:

{
  "id": "video_starvideos_o3_1234567890",
  "object": "video",
  "created": 1774836724,
  "model": "starvideos_o3",
  "status": "failed",
  "video_url": null,
  "error": "Reference image resolution is too low."
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

StarVideos O3: 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