Source: https://01router.com/docs/models/seedance-2.5/create
Base URL: https://01router.com/api/v1

# Seedance 2.5 · Create a generation

Pass the model id, its unified input parameters and optionally a provider slug. The response returns immediately with the task id; image models on synchronous providers may already be succeeded.

`POST /api/v1/generations`

Bearer API key

## Input parameters

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| model | string | yes | Model slug from the catalog. Project keys may use a project-specific model slug. | options: [   "seedance-2.5" ] |
| input | object | yes | Model-specific input object. See the selected model reference for required fields, defaults and limits. |  |
| provider | string | no | Optional provider slug. Omit for automatic routing; project settings may pin the provider. |  |
| project | string | no | Optional project ID. Use its published model catalog and routing configuration. |  |
| callback_url | string<uri> | no | Public HTTPS URL, up to 1,000 characters. Receives the final generation object. Private network addresses are rejected. |  |
| input.prompt | string | yes |  |  |
| input.image_url | string<uri> | no | Optional start image (image-to-video) |  |
| input.end_image_url | string<uri> | no |  |  |
| input.duration | integer | no |  | default: 5; min: 4; max: 30 |
| input.resolution | enum | no |  | default: "720p"; options: [   "480p",   "720p",   "1080p" ] |
| input.aspect_ratio | enum | no |  | default: "16:9"; options: [   "16:9",   "9:16",   "1:1",   "4:3",   "3:4",   "21:9" ] |
| input.generate_audio | boolean | no |  | default: true |

## Response fields

| Field | Type | Required | Description | Constraints |
| --- | --- | --- | --- | --- |
| id | string | — | Generation ID returned by the create request. |  |
| object | "generation" | — | generation |  |
| model | string | — | Model slug from the catalog. Project keys may use a project-specific model slug. |  |
| type | video \| image \| audio \| chat | — |  |  |
| provider | string | — | Optional provider slug. Omit for automatic routing; project settings may pin the provider. |  |
| status | string | — | queued / processing / succeeded / failed. Stop polling on succeeded or failed. |  |
| input | object | — | Model-specific input object. See the selected model reference for required fields, defaults and limits. |  |
| outputs | string[] | — | Result file URLs. Empty until available; download promptly because URLs may expire. |  |
| error | string \| null | — | Error message on failure; null otherwise. |  |
| credits | number | — | Credits charged for this generation; zero after a refund. |  |
| price_usd | number | — | Price of this generation in USD; zero after a refund. |  |
| created_at | string | — | Creation time in ISO 8601 format. |  |
| completed_at | string \| null | — | Completion time in ISO 8601 format, or null while running. |  |

## cURL

```bash
curl 'https://01router.com/api/v1/generations' \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "seedance-2.5",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  }
}'
```

## 200 · application/json

```json
{
  "id": "gen_example",
  "object": "generation",
  "model": "seedance-2.5",
  "type": "video",
  "provider": "fal",
  "status": "processing",
  "input": {
    "prompt": "A cinematic landscape at sunrise.",
    "duration": 5,
    "resolution": "720p",
    "aspect_ratio": "16:9",
    "generate_audio": true
  },
  "outputs": [],
  "error": null,
  "credits": 100,
  "price_usd": 1,
  "created_at": "2026-10-25T08:00:00.000Z",
  "completed_at": null
}
```

## Usage notes

- Poll at intervals of at least 3 seconds. A 504 from the synchronous image endpoint means the task may still be running: poll its error.id instead of submitting it again.