Skip to content

docs(seedance): document reference task type #856

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Closed
Copilot wants to merge 2 commits into from
Closed

docs(seedance): document reference task type #856

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8e824f0
Initial plan
Copilot Sep 2, 2026
4ae9976
docs(seedance): document reference task type
Copilot Sep 2, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions seedance/docs/seedance_videos_generation_api_integration_guide.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,6 +38,7 @@ The most basic usage is to input a `content` array containing a single text item
- `generate_audio`: whether to generate audio. Supported by Seedance 1.5 Pro and 2.x; other models ignore it. Default `false`.
- `callback_url`: an asynchronous callback URL. When provided, the API returns immediately with a `task_id` and POSTs the result to this URL when generation completes.
- `async`: optional. When `true`, the API returns immediately with a `task_id` (no `callback_url` required); poll the result with the Seedance Tasks API.
- `omni_reference_task_type`: Seedance 2.5 only: `auto`, `reference`, `edit`, or `extend`.

### Request Example

Expand Down Expand Up @@ -110,7 +111,7 @@ Image roles:
- `last_frame` — the image is used as the closing frame.
- `reference_image` — the image is used as a style / subject / real-person reference.

`first_frame` and `last_frame` may be combined in a single request, but `reference_image` is mutually exclusive with `first_frame` / `last_frame`.
`first_frame` and `last_frame` may be combined in a single request. They cannot be combined with `reference_image`, `reference_video`, or `reference_audio`. To indicate a first or last frame in a multimodal reference, use `reference_image` and state it in the prompt; use `first_frame` / `last_frame` when the frames must be strictly locked.

### Real-Person / Character Reference (Seedance 2.0)

Expand Down Expand Up @@ -167,4 +168,4 @@ Each error response includes a `trace_id` to help with debugging and support.

## Seedance 2.5 controls

Seedance 2.5 accepts up to 30 reference images, 10 videos, and 10 audios (50 media items total), including pure-audio reference. First/last-frame, edit, and extend tasks require `ratio: "adaptive"`; edit also requires `duration: -1`. Use `output_format` (`mp4`/`mov`), `return_last_frame`, `priority` (0–9), a stable anonymous `safety_identifier`, and the optional web search tool `[{"type":"web_search"}]` as needed.
Seedance 2.5 accepts up to 30 reference images, 10 videos, and 10 audios (50 media items total), including pure-audio reference. Set `omni_reference_task_type` to `reference` when providing at least one `reference_image`, `reference_video`, or `reference_audio`. First/last-frame, edit, and extend tasks require `ratio: "adaptive"`; edit also requires `duration: -1`. Use `output_format` (`mp4`/`mov`), `return_last_frame`, `priority` (0–9), a stable anonymous `safety_identifier`, and the optional web search tool `[{"type":"web_search"}]` as needed.