Skip to main content

​
Base URL

https://seedance2-pro.com/api/v1

​
Authentication

All endpoints require a Bearer token: 
Authorization: Bearer YOUR_API_KEY
See Authentication for details.

​
Endpoints

Text to Video

Generate video from text prompts

Image to Video

Generate video from images

Omni Reference

Visual references with @N syntax

Get Task Status

Check progress and retrieve results

​
Request Flow

1

Create Task

Submit a generation request with model and parameters
2

Receive Task ID

Get a unique task ID to track progress
3

Poll Status

Check task status every 3-5 seconds
4

Retrieve Result

Download generated video when status is success

​
Response Format

Success responses return data directly without a wrapper: 
{
  "taskId": "task_clxxxxxx"
}
Error responses return a message with the appropriate HTTP status code: 
{
  "message": "Invalid request parameters"
}

​
Error Codes

HTTP StatusMeaningCommon Causes
200SuccessRequest completed
400Bad RequestInvalid parameters
401UnauthorizedInvalid or missing API key
402Payment RequiredInsufficient credits
403ForbiddenAPI access not enabled
404Not FoundTask doesn’t exist
500Server ErrorInternal error (retry)

​
Supported Model

Use seedance-20 as the model:
  • Text to Video — generate from text prompt. See Text to Video.
  • Image to Video — provide a source image, generate video. See Image to Video.
  • Omni Reference — use images/videos as visual references. See Omni Reference.
{
  "model": "seedance-20",
  "inputs": {
    "prompt": "...",
    "resolution": "1280x720",
    "duration": "5s"
  }
}

​
Credits

Rate5s10s15s
40 credits/sec200400600
See Pricing for details.

​
Support