GlobalAiOpc

Seedance2.0 - Query Task

Query the status and results of Seedance2.0 video generation tasks

GET/kyyReactApiServer/v1/result/{id}

Seedance2.0 Query Video Task

Use the task ID to query the status and results of Seedance2.0 video generation tasks.

Authentication

Get Key

All requests require a Bearer token in the request header:

cURL

Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer

baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Path Parameters

idstringrequired

Unique identifier for the video generation task, returned from the create task API

Example: video_fd35ee52-2a98-44a6-b930-29a88ce9b8fd

Response Parameters

idstring

Unique identifier for the video generation task

objectstring

Object type, always video

createdinteger

Task creation timestamp

modelstring

Model name used (seedance_2_0, seedance_2_0_fast, seedance_2_0_pro, seedance_2_0_fast_pro)

statusstring

Task status:

queued - Queued
processing - Processing
completed - Completed
failed - Failed

video_urlstring

Generated video URL, returned when status is completed

actualDurationnumber

Actual video output duration in seconds, returned when status is completed

totalTokensinteger

Total tokens consumed, returned when status is completed

errorstring

Error message, returned when status is failed

Status Flow

queued

Task created and added to queue, waiting for processing

processing

Task is being processed, Seedance2.0 model is generating the video

completed

Task completed, video generated successfully, available via video_url

Polling Recommendations

Polling Strategy:

Recommended polling interval: 20-40 seconds
Fast models (seedance_2_0_fast, seedance_2_0_fast_pro) generate faster, can use shorter polling intervals
Avoid overly frequent requests to prevent rate limiting
Stop polling when status is completed or failed

Video URL Information

Important Notes:

Generated video URLs are valid for 1 day
Download and save videos to your storage system promptly
Videos cannot be accessed after URL expiration
Video files are typically in MP4 format
Depending on the generateAudio parameter, videos may or may not contain audio

Generation Time Estimates

Standard Models

seedance_2_0 / seedance_2_0_pro

Estimated generation time: 2-5 minutes

Fast Models

seedance_2_0_fast / seedance_2_0_fast_pro

Estimated generation time: 1-3 minutes

Factors Affecting Generation Time:

Video duration: Longer duration requires more generation time
Model type: Fast models generate faster
Reference materials: Using multimodal references (images, videos, audio) may increase processing time
System load: Peak times may require longer queue times

Model Generation Speed Comparison

Model	Average Generation Time	Use Case
seedance_2_0	2-5 minutes	Standard quality, supports reference videos
seedance_2_0_fast	1-3 minutes	Fast generation, supports reference videos
seedance_2_0_pro	3-6 minutes	High quality output
seedance_2_0_fast_pro	2-4 minutes	High quality fast generation