Seedance 2.5 | BeatAPI API Documentation

curl -X POST https://api.beatapi.io/v1/videos/tasks \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{
  "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
}'

{
  "data": {
    "capability_id": "seedance-2.5",
    "capability_version": null,
    "completed_at": null,
    "created_at": 1782210000,
    "error_code": null,
    "error_message": null,
    "id": "task_8K2qA",
    "media_type": "video",
    "model": "seedance-2.5",
    "object": "task",
    "output": null,
    "request_id": "req_abc123",
    "stage": "queued",
    "status": "queued",
    "task_kind": "video",
    "updated_at": 1782210000,
    "usage": {
      "billable_duration_seconds": 5,
      "credits_charged": 1.55,
      "credits_refunded": 0,
      "credits_reserved": 1.55,
      "credits_settled": 0
    }
  }
}

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

Supported modes

Mode	Required input	Rules
Text to video	`model`, `prompt`	Omit all media arrays.
First frame	`model`, `prompt`, `images`	Provide one image URL; provide two for first and last frames.
Multimodal references	`model`, `prompt`, one `reference_*` array	Audio references also require a reference image or video.

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.

Generate 4–30 second 480p, 720p, or 1080p videos from text, first/last frames, or larger multimodal reference sets. ### Supported modes | Mode | Required input | Rules | | --- | --- | --- | | Text to video | `model`, `prompt` | Omit all media arrays. | | First frame | `model`, `prompt`, `images` | Provide one image URL; provide two for first and last frames. | | Multimodal references | `model`, `prompt`, one `reference_*` array | Audio references also require a reference image or video. | **Async flow:** Create the task, save `data.id`, then [poll the Task](/quick-guide#get-task-status) 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](/quick-guide#errors-and-retry-policy). **Using a local file?** [upload a local input](/quick-guide#upload-an-input-file) first and pass the returned `data.url`.

Authentication

AuthorizationBearer

Send your API key as Authorization: Bearer <BEATAPI_API_KEY>.

Request

This endpoint expects an object.

model"seedance-2.5"Required

Must be seedance-2.5.

promptstringRequired1-5000 characters

Video generation instructions.

imageslist of stringsOptional

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

reference_imageslist of stringsOptional

Public HTTPS image references for multimodal reference generation.

reference_videoslist of stringsOptional

Public HTTPS video references for multimodal reference generation.

reference_audioslist of stringsOptional

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

durationintegerOptional4-30Defaults to 5

Requested output duration in seconds.

aspect_ratioenumOptionalDefaults to adaptive

Output video aspect ratio.

resolutionenumOptionalDefaults to 720p

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

generate_audiobooleanOptionalDefaults to true

Generate synchronized audio with the video.

seedintegerOptional-1-4294967295Defaults to -1

Reproducibility seed. Use -1 for a random seed.

Response

Video generation task accepted

Errors

400

Bad Request Error

401

Unauthorized Error

402

Payment Required Error

409

Conflict Error

429

Too Many Requests Error

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

Supported modes

Mode	Required input	Rules
Text to video	`model`, `prompt`	Omit all media arrays.
First frame	`model`, `prompt`, `images`	Provide one image URL; provide two for first and last frames.
Multimodal references	`model`, `prompt`, one `reference_*` array	Audio references also require a reference image or video.

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

Supported modes

Authentication

Headers

Request

Response

Errors

Supported modes