Seedance 2.0 Video Generation — Query Task and Status

After you create a Seedance 2.0 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".

Video generation is asynchronous. Fast model variants (seedance_2_0_fast, seedance_2_0_fast_pro) typically complete sooner and can be polled at shorter intervals.

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.Example: video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

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 Seedance 2.0 model used for generation. One of: seedance_2_0, seedance_2_0_fast, seedance_2_0_pro, seedance_2_0_fast_pro.

string

Current task status:

queued — task is in the queue, waiting to be processed
processing — the 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". Valid for 1 day — download and store the video promptly.

number

The actual output duration of the video in seconds. Only present when status is "completed".

integer

The total number of tokens consumed by this generation task. Only present when status is "completed". Use this value for cost tracking and quota management.

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`	Seedance 2.0 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

Use a 20–40 second polling interval as the default. For fast model variants, you can shorten this to 10–20 seconds.

Model	Recommended Poll Interval	Estimated Generation Time
`seedance_2_0`	every 20–40 s	2–5 min
`seedance_2_0_fast`	every 10–20 s	1–3 min
`seedance_2_0_pro`	every 20–40 s	3–6 min
`seedance_2_0_fast_pro`	every 10–20 s	2–4 min

Stop polling immediately when status is "completed" or "failed".
Avoid polling more frequently than every 10 seconds to prevent rate limiting.

Factors that affect generation time:

Video duration: longer durations take more time
Model type: fast variants generate more quickly
Reference media: adding multi-modal references (images, videos, audio) may increase processing time
System load: peak usage periods may result in longer queue times

Video URL Notes

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

Format: MP4
Audio: present if generateAudio was true during task creation; silent if false
Retention: 1 day

Code Examples

curl --request GET \
  --url https://zcbservice.aizfw.cn/kyyReactApiServer/v1/result/video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd \
  --header 'Authorization: Bearer YOUR_API_KEY'

import time
import requests

BASE_URL = "https://zcbservice.aizfw.cn/kyyReactApiServer"
API_KEY = "YOUR_API_KEY"
TASK_ID = "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd"

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

# Use a shorter interval for fast model variants
POLL_INTERVAL = 20

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"Actual duration: {data.get('actualDuration')}s")
        print(f"Tokens used: {data.get('totalTokens')}")
        break
    elif status == "failed":
        print(f"Generation failed: {data.get('error')}")
        break

    time.sleep(POLL_INTERVAL)

Example response — queued:

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "queued",
  "video_url": null,
  "error": null
}

Example response — completed:

{
  "id": "video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd",
  "object": "video",
  "created": 1774836724,
  "model": "seedance_2_0_fast",
  "status": "completed",
  "video_url": "https://cdn.example.com/videos/video_fd35ee52.mp4",
  "actualDuration": 8,
  "totalTokens": 1240,
  "error": null
}

Overview

Text APIs

Image APIs

Video APIs

Asset Management

Seedance 2.0 Video Generation — Query Task and Status

Endpoint

Path Parameters

Response Fields

Status Flow

Polling Recommendations

Video URL Notes

Code Examples

​Endpoint

​Path Parameters

​Response Fields

​Status Flow

​Polling Recommendations

​Video URL Notes

​Code Examples

Endpoint

Path Parameters

Response Fields

Status Flow

Polling Recommendations

Video URL Notes

Code Examples