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 credits

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-30T11:01:47Z"
}

Completed Response

json

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

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