Create a task
Submit a generation task for any model.
POST
/api/v1/jobs/createTaskCreates an asynchronous generation task. Every model uses this endpoint. Credits are charged when the request is accepted.
Request body
{
"model": "seedance-2.0",
"input": {
"prompt": "a cat stretching on a sunlit windowsill"
},
"callBackUrl": "https://your-server.com/webhook"
}Common fields
| Field | Type | Required | Notes |
|---|---|---|---|
model | string | Yes | Model identifier, see the table below |
input | object | Yes | Model-specific parameters, documented on each model page |
callBackUrl | string | No | Omit it and poll the query endpoint instead |
Models
| Model | model value | Type |
|---|---|---|
| Seedance 2.0 | seedance-2.0 | Video |
| Seedance 2.0 Fast | seedance-2.0-fast | Video |
Response
{
"code": 200,
"msg": "success",
"data": {
"taskId": "xb_a1b2c3d4e5f6...",
"creditsCharged": 165
}
}Store taskId immediately. Use it to query status and deduplicate callbacks.
Billing behavior
Credits are charged when the task is submitted. The amount is calculated from output duration and the model rate. A task that reaches the failed state is refunded in full automatically.