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 |
| Seedance 2.0 Global | seedance-2.0-global | Video |
| Seedance 2.0 Fast Global | seedance-2.0-fast-global | Video |
| Seedance 2.5 | seedance-2.5 | Video |
| Seedance 2.5 Global | seedance-2.5-global | Video |
| MiniMax H3 | hailuo-h3 | 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. H3 also bills input video duration and reference images beyond the first 5; see pricing. A task that reaches the failed state is refunded in full automatically.