Seedance 2.5

POST https://api.beatapi.io/v1/videos/tasks

Generate 4–30 second 480p, 720p, or 1080p videos from text, first/last frames, or larger multimodal reference sets.

Supported modes

Async flow: Create the task, save data.id, then poll the Task with GET /v1/tasks/{task_id}. On succeeded, read data.output.media. On failed, read data.error_code and data.error_message, then follow the error and retry policy.

Using a local file? upload a local input first and pass the returned data.url.

Authorization

Authorization   string   required

Send your BeatAPI API key as a Bearer token. Create one on the Dashboard.

Authorization: Bearer <BEATAPI_API_KEY>

Keep permanent API keys on trusted servers. Content-Type: application/json is required for the request body. Idempotency-Key is optional when the endpoint exposes it and is recommended for safe retries with the exact same body.

Request body

model   string   required

Must be seedance-2.5.

Value: seedance-2.5

prompt   string   required

Video generation instructions.

Length: 1 to 5000 characters

images   string[]   optional

One first-frame image or first- and last-frame images as public HTTPS URLs.

Count: 1 to 2 items

reference_images   string[]   optional

Public HTTPS image references for multimodal reference generation.

Count: 1 to 30 items

reference_videos   string[]   optional

Public HTTPS video references for multimodal reference generation.

Count: 1 to 10 items

reference_audios   string[]   optional

Public HTTPS audio references. Audio-only reference generation is supported.

Count: 1 to 10 items

duration   integer   optional

Requested output duration in seconds.

Default: 5
Range: 4 to 30

aspect_ratio   enum<string>   optional

Output video aspect ratio.

Available options: adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16
Default: "adaptive"

resolution   enum<string>   optional

Output resolution tier. 480p and 1080p are priced separately; see the pricing page.

Available options: 480p, 720p, 1080p
Default: "720p"

generate_audio   boolean   optional

Generate synchronized audio with the video.

Default: true

seed   integer   optional

Reproducibility seed. Use -1 for a random seed.

Default: -1
Range: -1 to 4294967295

Request examples

Text to video

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2.5",
>
  "prompt": "A cinematic tracking shot through a rain-lit night market.",
>
  "duration": 5,
>
  "aspect_ratio": "16:9",
>
  "resolution": "720p",
>
  "generate_audio": true,
>
  "seed": -1
>
}'

First frame

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2.5",
>
  "prompt": "Animate the performer with a dramatic push-in and synchronized ambient sound.",
>
  "images": [
>
    "https://media.beatapi.io/samples/neon-singer.png"
>
  ],
>
  "duration": 5,
>
  "resolution": "720p",
>
  "generate_audio": true,
>
  "seed": -1
>
}'

Multimodal references

$
curl --request POST \
>
  --url https://api.beatapi.io/v1/videos/tasks \
>
  --header 'Authorization: Bearer <BEATAPI_API_KEY>' \
>
  --header 'Content-Type: application/json' \
>
  --data '{
>
  "model": "seedance-2.5",
>
  "prompt": "Build a coherent performance from the supplied visual and audio references.",
>
  "reference_images": [
>
    "https://media.beatapi.io/samples/neon-singer.png"
>
  ],
>
  "reference_audios": [
>
    "https://media.beatapi.io/samples/neon-singer-preview.mp3"
>
  ],
>
  "duration": 8,
>
  "resolution": "720p",
>
  "generate_audio": true,
>
  "seed": -1
>
}'

Response

A successful request returns HTTP 201.

1
{
2
  "data": {
3
    "id": "task_8K2qA",
4
    "object": "task",
5
    "task_kind": "video",
6
    "capability_id": "seedance-2.5",
7
    "capability_version": null,
8
    "media_type": "video",
9
    "model": "seedance-2.5",
10
    "status": "queued",
11
    "stage": "queued",
12
    "created_at": 1782210000,
13
    "updated_at": 1782210000,
14
    "completed_at": null,
15
    "output": null,
16
    "usage": {
17
      "credits_reserved": 1.55,
18
      "credits_charged": 1.55,
19
      "billable_duration_seconds": 5,
20
      "credits_settled": 0,
21
      "credits_refunded": 0
22
    },
23
    "request_id": "req_abc123",
24
    "error_code": null,
25
    "error_message": null
26
  }
27
}

Errors