Skip to main content
POST
Angi size til en WxH-verdi fra størrelsestabellen for modellen din.
Bruk doubao-seedance-2-0-mini nøyaktig for Seedance 2.0 Mini. Den forkortede seedance-mini-verdien er ikke en gyldig modell-ID.

Støttede modell-ID-er

Velg en modell for inndatamodusen og oppløsningen din, og send deretter den nøyaktige ID-en i feltet model.

Bruk referansebilder

Send POST /v1/videos som multipart/form-data, med referansebilder i input_reference. For flere bilder gjentar du feltet i bilderekkefølge, med én offentlig tilgjengelig HTTPS-bilde-URL eller én opplastet bildefil per felt. Bruk bare URL-er eller bare filer i dette feltet. Send hver URL separat i stedet for å sette sammen URL-er med kommaer. Hold hvert opplastede bilde på eller under 20 MiB (20 × 1024 × 1024 byte). Seedance 1.0 Pro og 1.5 Pro bruker ett referansebilde. Seedance 2.0, Fast og Mini godtar opptil 9 referansebilder. Seedance 2.5 godtar opptil 30 referansebilder. Disse antallene gjelder både URL-er og opplastede filer. I Prompt-en skal du gi hvert bilde en rolle, for eksempel motivet, miljøet eller den visuelle stilen. Beskriv utseendet som skal bevares, handlingen og kamerabevegelsen. Forespørselseksemplene øverst på denne siden viser inndata med bilde-URL-er og opplasting av ett eller flere bilder.

Send URL-er for referansebilder

Bruk to bilde-URL-er for å styre motivets utseende og miljø:

Bruk referansevideo og -lyd

Seedance 2.0, Fast, Mini og 2.5 godtar reference_videos og reference_audios. Bruk MP4-filer for videoreferanser og MP3-filer for lydreferanser. Send hver av dem som en offentlig tilgjengelig HTTPS-URL eller en opplastet fil. Kombiner referanselyd med minst ett bilde eller én video. Bruk @Image1, @Video1 og @Audio1 i Prompt for å tilordne roller til referansene dine. Nummerer referansene etter rekkefølgen deres innen hver medietype. Du kan kombinere URL-er og opplastinger på tvers av ulike felt. I hver av input_reference, reference_videos og reference_audios bruker du enten bare URL-er eller bare filer. For flere inndata gjentar du feltet én gang per inndata i stedet for å sette sammen URL-er med kommaer. Hold hver opplastede video på maksimalt 50 MiB og hver opplastede lydfil på maksimalt 15 MiB. Én MiB er 1024 × 1024 byte. Standard Seedance 2.0 (doubao-seedance-2-0) har ytterligere mediegrenser for både URL-er og opplastede filer. For referansevideoer må den samlede varigheten være mellom 2 og 15 sekunder, og den totale størrelsen under 50 MB. Bruk en referansevideooppløsning på omtrent 480p (640x640) til 720p (834x1112). For referanselyd må den samlede varigheten være maksimalt 15 sekunder, og hver fil maksimalt 15 MB. Opplastede medier må også oppfylle opplastingsgrensene per fil ovenfor.

Send en URL for referansevideo

Bruk referansevideoen til å styre kamerabevegelsen og handlingen:

Kombiner en bilde-URL med lyd

Animer referansemotivet i takt med referanselyden:

Last opp referansemedier med Seedance 2.5

Last opp to bilder, en MP4-video og en MP3-lydfil i én forespørsel:

Varighet etter modell

Angi seconds til en heltallsverdi innenfor modellens område. Hvis du utelater den, ber CometAPI om et klipp på 5 sekunder.

Størrelsesstøtte etter modell

Seedance 2.5

For Seedance 2.5 gjelder disse WxH-verdiene både for tekstprompter og referansemedier.

Tidligere Seedance-modeller

Den siste kolonnen grupperer eksakte WxH-verdier for Seedance 1.5 Pro, standard Seedance 2.0 og Fast. Seedance 2.0 Fast bruker bare verdiene 480p og 720p i den kolonnen. 1080p-verdiene i den kolonnen gjelder for Seedance 1.5 Pro og standard Seedance 2.0. 4K-verdiene gjelder bare for standard Seedance 2.0. I Mini-kolonnen betyr at oppløsningen ikke støttes.
Seedance 2.0 Mini støtter 480p og 720p. Angi size til en WxH-verdi fra Mini-kolonnen.

Autorisasjoner

Authorization
string
header
påkrevd

Bearer token authentication. Use your CometAPI key.

Kropp

multipart/form-data
prompt
string
påkrevd

Text prompt that describes the video. Required. When using reference images, describe what each image should control, such as the subject from @Image1, the secondary object from @Image2, and the background or style from @Image3. Also state the action, camera motion, visual style, and scene.

Eksempel:

"A slow cinematic camera push across a coastal landscape at sunrise."

model
enum<string>
påkrevd

Seedance model ID. Use one of the exact values below. Aliases such as seedance-mini are not accepted.

Tilgjengelige alternativer:
seedance-2-5,
doubao-seedance-2-0,
doubao-seedance-2-0-fast,
doubao-seedance-2-0-mini,
doubao-seedance-1-5-pro,
doubao-seedance-1-0-pro
Eksempel:

"doubao-seedance-2-0-mini"

seconds
integer
standard:5

Video duration in seconds. Seedance 2.5 accepts 4 to 30. Seedance 2.0, Seedance 2.0 Fast, and Seedance 2.0 Mini accept 4 to 15. Seedance 1.5 Pro accepts 4 to 12, and Seedance 1.0 Pro accepts 2 to 10. The default is 5.

Nødvendig område: 2 <= x <= 30
Eksempel:

5

size
string

Output size as an exact WxH value. For Seedance 2.5 text-to-video and image-to-video, use 854x480, 752x560, 640x640, 560x752, 480x854, or 992x432 for 480p; use 1280x720, 1112x834, 960x960, 834x1112, 720x1280, or 1470x630 for 720p. For Seedance 2.0 Mini, use 864x496, 752x560, 640x640, 560x752, 496x864, or 992x432 for 480p; use the same documented 720p values. The standard Seedance 2.0 model also accepts its documented 4K values.

Pattern: ^[1-9]\d{2,3}x[1-9]\d{2,3}$
Eksempler:

"854x480"

"480x854"

"864x496"

"752x560"

"640x640"

"560x752"

"496x864"

"992x432"

"1280x720"

"1112x834"

"960x960"

"834x1112"

"720x1280"

"1470x630"

"1920x1080"

"1080x1920"

"3840x2160"

"3326x2494"

"2880x2880"

"2494x3326"

"2160x3840"

"4398x1886"

input_reference

Reference images: repeat input_reference with one publicly accessible HTTPS image URL or one uploaded image file per field. Use only URLs or only files within this field; do not join URLs with commas. Keep each uploaded image at or below 20 MiB. Seedance 2.0, Fast, and Mini allow up to nine image URLs or files and 12 reference inputs in total. Seedance 2.5 allows up to 30 image URLs or files and 50 reference inputs in total. For Seedance 1.0 Pro and 1.5 Pro, send one URL or one file. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://
reference_videos
(string<uri> | file)[]

Reference video inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_videos with a publicly accessible HTTPS MP4 URL or an uploaded MP4 file. Use only URLs or only files within this field. Each file can be up to 50 MiB. Seedance 2.0, Fast, and Mini allow up to three video inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten video URLs or five uploaded video files, with 50 reference inputs in total. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded references must have a combined video duration of 2 to 15 seconds and a total video size under 50 MB. Each reference video must have a resolution of approximately 480p (640x640) to 720p (834x1112). These media limits apply in addition to the 50 MiB per-file upload limit.

Required array length: 1 - 10 elements
Pattern: ^https://
Eksempel:

"https://your-media-host/reference.mp4"

reference_audios
(string<uri> | file)[]

Reference audio inputs for Seedance 2.0, Fast, Mini, and 2.5. Repeat reference_audios with a publicly accessible HTTPS MP3 URL or an uploaded MP3 file. Use only URLs or only files within this field. Each file can be up to 15 MiB. Seedance 2.0, Fast, and Mini allow up to three audio inputs and 12 reference inputs in total. Seedance 2.5 allows up to ten audio URLs or five uploaded audio files, with 50 reference inputs in total. Pair audio with at least one reference image or video. For standard Seedance 2.0 (doubao-seedance-2-0), URL and uploaded audio references must have a combined duration at or below 15 seconds, with each audio file at or below 15 MB. These media limits apply in addition to the 15 MiB per-file upload limit.

Required array length: 1 - 10 elements
Pattern: ^https://
Eksempel:

"https://your-media-host/reference.mp3"

Svar

Task created. Save the returned id and poll GET /v1/videos/{id}.

id
string
påkrevd

Task id. Use it as the path parameter for GET /v1/videos/{id}.

object
string
påkrevd

Object type, always video.

model
string
påkrevd

Echo of the requested model id.

status
enum<string>
påkrevd

Initial task status. Newly created tasks are returned as queued.

Tilgjengelige alternativer:
queued,
in_progress,
completed,
failed,
error
progress
integer
påkrevd

Completion percentage. 0 at creation.

Nødvendig område: 0 <= x <= 100
created_at
integer
påkrevd

Task creation time as a Unix timestamp in seconds.

task_id
string

Alias of id returned for compatibility. The value matches id.

Sist endret 9. september 2026