Video Generation

Seedance 2 Reference API

Seedance 2.0 multimodal reference-to-video. Combine up to 9 images, 3 video clips, and 3 audio tracks to guide characters, motion, and sound. Integrate this model via REST with endpoint docs, parameters, and code examples.

Prompting guide Compare video models Use cases

Img2Vid

Credit Cost

−20% through October 8

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-reference/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-reference.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` required	string	Text instruction describing what to generate or edit.	-
`reference_images`	array	Optional reference image URLs to bias style or subject. items: url max items: 9	-
`reference_videos`	array	Optional reference video URLs (up to 3). Combined duration across all clips must be 15 seconds or less. items: url max items: 3	-
`reference_audios`	array	Optional reference audio URLs (up to MAX_REFERENCE_AUDIOS). At least one reference image or video must also be supplied. items: url max items: 3	-
`quality`	enum	Generation quality tier. Higher tiers cost more credits. `fasthighmini`	`fast`
`duration`	integer	Output duration in seconds. min: 4 \| max: 15	`5`
`resolution`	enum	Output resolution. `480p720p1080p4k`	`720p`
`aspect_ratio`	enum	Output aspect ratio. `16:94:31:13:49:16`+2 more	`16:9`
`generate_audio`	boolean	Generate a soundtrack alongside the video.	`true`
`seed`	integer	Random seed for reproducibility. Same seed + inputs yields similar results. min: 0 \| max: 2147483647	-

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.

Example Outputs

Real outputs generated by this model

View Details

a peaceful landscape with a winding river at sunset

0 credits

Code Examples

Multimodal references → video — copy and paste to get started

bash

curl -X POST "https://pixeldojo.ai/api/v1/models/seedance-2-reference/run" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "prompt": "The character from [Image1] performs the dance from [Video1] to [Audio1]",
    "reference_images": [
      "https://..."
    ],
    "reference_videos": [
      "https://..."
    ],
    "reference_audios": [
      "https://..."
    ],
    "duration": 5,
    "quality": "fast"
  }'

Response Format

Submit Response (202 Accepted)

json

{
  "jobId": "job_abc123...",
  "status": "pending",
  "statusUrl": "https://pixeldojo.ai/api/v1/jobs/job_abc123...",
  "creditCost": 20,
  "creditsRemaining": 95,
  "expiresAt": "2026-10-10T02:49:10Z"
}

Completed Response

json

{
  "jobId": "job_abc123...",
  "status": "completed",
  "output": {
    "video": "https://temp.pixeldojo.ai/pixeldojotemp/1705930123-456789.mp4"
  },
  "creditCost": 20,
  "expiresAt": "2026-10-10T02:49:10Z"
}

LLM Documentation Try in Web UI Get API Key Usage Dashboard Buy Credits