Seedance 2 | 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",
  "prompt": "A handheld tracking shot through a crowded neon night market.",
  "duration": 8,
  "aspect_ratio": "16:9",
  "resolution": "1080p",
  "generate_audio": true
}'

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

Generate 4–15 second videos from text, first/last frames, or multimodal references, with optional generated audio.

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–15 second videos from text, first/last frames, or multimodal references, with optional generated audio. ### 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"Required

Must be seedance-2.

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 also requires at least one reference image or video.

durationintegerOptional4-15Defaults to 5

Requested output duration in seconds.

aspect_ratioenumOptionalDefaults to adaptive

Output video aspect ratio.

resolutionenumOptionalDefaults to 720p

Output resolution tier. 4k and 4K are equivalent. 1080p is not supported with reference images.

generate_audiobooleanOptionalDefaults to true

Generate synchronized audio with the video.

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–15 second videos from text, first/last frames, or multimodal references, with optional generated audio.

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