Seedance Official Edition Video API

This page specifies the Seedance official edition video models. They share the POST /v1/videos create and GET /v1/videos/{id} polling flow with the other video models; authentication, media upload, polling states, downloads and error handling are covered in the Complete Video API Standard. This page lists only the fields and rules specific to this group.

Updated 2026-10-10. These models support polling only: do not send callback_url, or the request is rejected. The SD cloud edition (SD2.0, SD2.5) and Seedance Official Relay behave differently; see SD Cloud Edition and Seedance Official Relay.

Models

Use the exact id returned by GET /v1/models, including the 官方版 suffix. Each series sells one model name; resolution selects the output tier and the tier that is billed, and the name stays the same when tiers are added.

Common rules

• Resolution: send a tier from the table in resolution, in either case (720p and 720P are equivalent). Without it, the lowest tier is used. A tier the series does not offer returns 400; it is never downgraded.
• Duration: whole seconds in duration (or the string seconds). Without it, the default duration above applies.
• Aspect ratio: ratio (or aspect_ratio) accepts 16:9, 9:16, 1:1, 4:3, 3:4 and 21:9. The default is 16:9; auto is not supported.
• Prompt: prompt is required.
• Audio: there is no generated-audio switch; do not send generate_audio.
• Optional fields: negative_prompt and seed (integer).

Reference media

• Put reference images in the top-level images array.
• Put reference videos in metadata.referenceVideos and reference audio in metadata.referenceAudios.
• Use one field per media type. If several aliases are sent, only one set is used; they are not merged.
• See Media URL requirements and Local media upload.

{
  "model": "seedance-2.5官方版",
  "resolution": "720p",
  "prompt": "Use the product appearance from the images, the camera rhythm of the video and the mood of the audio for a tech ad",
  "duration": 10,
  "ratio": "16:9",
  "images": [
    "https://cdn.example.com/product-front.jpg",
    "https://cdn.example.com/product-detail.jpg"
  ],
  "metadata": {
    "referenceVideos": ["https://cdn.example.com/motion-reference.mp4"],
    "referenceAudios": ["https://cdn.example.com/sound-reference.mp3"]
  }
}

First and last frames

Put keyframes in metadata.firstFrame and metadata.lastFrame. lastFrame requires firstFrame. Keyframes cannot be combined with reference images, videos or audio.

{
  "model": "seedance-2.0官方版",
  "prompt": "Transition smoothly from an empty square at dawn to the same view at night with the lights on",
  "duration": 8,
  "ratio": "16:9",
  "metadata": {
    "firstFrame": "https://cdn.example.com/start.jpg",
    "lastFrame": "https://cdn.example.com/end.jpg"
  }
}

File upload

You can also send one local image with multipart/form-data in the input_reference field; do not send images or image in the same request. Reference videos and audio cannot be sent as files; obtain a URL through Local media upload first.

Earlier model names

The earlier names Seedance-2.5-720p官方版, Seedance-2.0-720p官方版, Seedance-2.0-fast-720p官方版, seedance-2.0-mini-480p and seedance-2.0-mini-720p still work. Their output and billing stay at the tier in the name, and resolution is ignored. They are no longer listed in the model square; new integrations should use the series names above with resolution.