Skip to main content
GET
  • Query async video generation task execution status and results
  • Real-time status updates and progress tracking
  • Get generated videos when task completes
  • Multi-language support (zh/en/ko/ja)
All video generation tasks are executed asynchronously. After submitting a task, you need to query the status and results via the query endpoint.

Authorizations

string
required
All endpoints require Bearer Token authenticationGet your API Key:Visit the API Key Management Page to get your API KeyAdd it to the request header:

Path Parameters

string
required
Task ID returned by the video generation API

Response

string
Unique task identifier
string
Object type, always generation.task
string
Task status
  • queued - Queued for processing
  • in_progress - Processing
  • completed - Successfully completed
  • failed - Failed
integer
Task progress percentage (0-100)
string
Video generation model used
integer
Task creation time (Unix timestamp)
integer
Task completion time (Unix timestamp, only returned when completed)
integer
Video URL expiration time (Unix timestamp, only returned on completion)
object
Task result (only returned on success)
object
Model tool usage. When Seedance 2 uses tools: [{ "type": "web_search" }], usage.tool_usage.web_search is the actual search count; 0 means no search was performed.
object
Error information (only returned on failure)

Task Status Reference

Polling Strategy

Python Polling Example

Resource Expiration

Generated video URLs are valid for 24 hours
  • Please download and save videos within the validity period
  • expires_at field indicates video expiration time (Unix timestamp)
  • Expired videos cannot be accessed; to regenerate, submit a new task
  • Thumbnails expire simultaneously with videos

Error Codes

Performance Tips

Video generation takes longer, recommendations:
  1. Use the ToAPIs Task Webhook: Prefer Webhooks and keep polling as fallback
  2. Set a Reasonable Polling Interval: At least 5–10 seconds with jitter; on 429, honor Retry-After and back off exponentially
  3. Set Timeout: Long videos may take 5-10 minutes, set reasonable timeout
  4. Download Promptly: Videos expire after 24 hours, save to your storage immediately
See Async task rate limits. A batch query accepts at most 100 task IDs.