Video Generation

Seedance 2.5 API

Seedance 2.5 — text-to-video, first/last frame, and multimodal reference-to-video. Up to 30 seconds in one request with native audio in 11 languages. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Audio

Credit Cost

6 credits/sec

Type

Video

Get API Key

Create auth keys for apps and agents

See Usage

Track requests, credits, and logs

Buy Credits

Top up prepaid API capacity

API Endpoint

POST

/api/v1/models/seedance-2-5/run

Test This Model

Run a real request through the API pipeline and inspect the exact input and output your integration will handle. Uses your credits like any API call; failed runs are refunded automatically.

LLM.txt

AI-Ready

For AI assistants

Copy this model's documentation into Claude, GPT, or any AI for instant integration help.

/llm/seedance-2-5.txt

OpenAPI Spec

Swagger compatible

Import into Postman, Swagger UI, or generate client SDKs in any language.

/api/openapi

Parameters

Input parameters accepted by this model

Parameter	Type	Description	Default
`prompt`	string	Text description of the video. Tag reference assets as @Image1, @Video1, @Audio1 and say what each one contributes. Required.	-
`first_frame_url`	url	Starting frame. Forces the output aspect ratio to match this image. Cannot be combined with reference assets.	-
`last_frame_url`	url	Ending frame. Requires first_frame_url.	-
`reference_images`	array	Up to 30 reference images. Cannot be combined with first/last frames.	-
`reference_videos`	array	Up to 10 reference videos, 30s combined.	-
`reference_video_seconds`	number	Combined length of reference_videos, in seconds. Seedance meters input video as well as output, so this is billed on top of duration. An ESTIMATE only — it is refined from the provider's own meter at settlement and the difference is refunded. Omit it and reference-video runs reserve the full 30s budget. min: 1 \| max: 30	-
`reference_audios`	array	Up to 10 reference audio tracks, 30s combined. Seedance 2.5 accepts audio-only references.	-
`resolution`	enum	Output resolution. Seedance 2.5 supports 480p, 720p, and 1080p. `480p720p1080p`	`720p`
`aspect_ratio`	enum	Output aspect ratio. Ignored (forced to "adaptive") when a first frame or a reference video is supplied, because the model matches that input. `16:94:31:13:49:16`+2 more	`16:9`
`duration`	integer	Clip length in seconds (4-30), or -1 to let the model choose. -1 is billed at 30s and refunded down on settle. min: -1 \| max: 30	`5`
`generate_audio`	boolean	Generate a native audio track (11 languages supported).	`true`
`thinking`	boolean	Let the model reason about the prompt before generating. Most useful on long multi-beat prompts. Costs no extra credits. Off by default.	`false`

Use saved characters (@Name)

Write @Name in the prompt to use a character, product, outfit, location, prop or style saved in the account's Character Studio, for example "@Mara on a beach at sunset". Its photos are added to reference_images automatically, after any images you send yourself, so your own image numbering is unchanged. List saved names with GET /api/v1/characters and save new ones with POST /api/v1/characters. An @word that names nothing saved stays plain text.

Supported Aspect Ratios

16:9

4:3

1:1

3:4

9:16

21:9

adaptive

Code Examples

Text → video — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/seedance-2-5/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "A slow dolly through a rain-soaked neon alley",
    "duration": 10,
    "resolution": "720p",
    "aspect_ratio": "16:9"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 30,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-09T09:03:41Z"
}

Completed Response