Hopp til hovedinnhold
POST
/
v1
/
videos
curl https://api.cometapi.com/v1/videos \ -H "Authorization: Bearer <COMETAPI_KEY>" \ -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise"' \ -F 'model="doubao-seedance-2-0-fast"' \ -F 'seconds="5"' \ -F 'size="16:9"' \ -F 'resolution="720p"'
{ "id": "task_abc123", "task_id": "task_abc123", "object": "video", "model": "doubao-seedance-2-0-fast", "status": "SUBMITTED", "progress": 0, "created_at": 1776681149 }
Bruk dette endepunktet for å starte en ByteDance Seedance-videojobb. Alle nivåer av Seedance-modeller deler samme forespørselsformat; du velger modellen ved å sette feltet model. Kallet returnerer umiddelbart en oppgave-id, og rendringen fortsetter i bakgrunnen.

​
Velg en modell

Model idTierNotes
doubao-seedance-2-02.0Høyeste kvalitet i 2.0-familien.
doubao-seedance-2-0-fast2.0Raskere variant av 2.0 for raske iterasjoner og forhåndsvisninger.
doubao-seedance-1-5-pro1.5 ProStøtter 1080p. Kun text-to-video.
doubao-seedance-1-0-pro1.0 ProStøtter 1080p og kortere klipp fra 2 sekunder. Kun text-to-video.
Se Models-siden for tilgjengelighet i sanntid.

​
Parameterområder

FieldTypeRequiredDefaultAllowed values
promptstringja—hvilken som helst tekst
modelstringja—doubao-seedance-2-0, doubao-seedance-2-0-fast, doubao-seedance-1-5-pro, doubao-seedance-1-0-pro
secondsintegernei5avhenger av modell (se nedenfor)
sizestringnei16:921:9, 16:9, 4:3, 1:1, 3:4, 9:16
resolutionstringnei720p480p, 720p for 2.0-modeller; 480p, 720p, 1080p for 1.5 Pro og 1.0 Pro
input_referencefilenei—JPEG, PNG eller WebP. Godtas bare av 2.0-modellene.

​
Varighetsområde etter modell

Modelseconds range
doubao-seedance-2-0, doubao-seedance-2-0-fast4 til 15
doubao-seedance-1-5-pro4 til 12
doubao-seedance-1-0-pro2 til 10
Å sende en verdi utenfor modellens område returnerer HTTP 400 med code: "InvalidParameter" og en melding om duration.

​
Støtte for image-to-video

Bare 2.0-modellene godtar en input_reference-fil. Å sende input_reference med doubao-seedance-1-5-pro eller doubao-seedance-1-0-pro returnerer HTTP 400 med en melding på formen the specified task_type r2v does not support model seedance-1-5-pro. Bruk disse modellene kun for text-to-video.

​
Last opp et referansebilde

Request body er multipart/form-data. For å kjøre image-to-video på en 2.0-modell, legg ved bildet som delen input_reference i samme forespørsel: 
curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer <COMETAPI_KEY>" \
  -F 'prompt="A slow cinematic camera push across a coastal landscape at sunrise."' \
  -F 'model="doubao-seedance-2-0"' \
  -F 'seconds="5"' \
  -F 'size="16:9"' \
  -F 'resolution="720p"' \
  -F 'input_reference=@/path/to/reference.jpg'
Erstatt /path/to/reference.jpg med den absolutte eller relative banen til bildet du vil bruke som anker for første bilde. Støttede formater er JPEG, PNG og WebP.

​
Oppgaveflyt

1

Send inn oppgaven

Send en POST-forespørsel med minst prompt og model. Lagre den returnerte id for neste trinn.
2

Poll oppgaven

Kall Hent en Seedance-video hvert 10. til 20. sekund.
3

Last ned resultatet

Når status blir SUCCESS, last ned filen på video_url og host den selv på nytt hvis du trenger langvarig tilgang. URL-en er signert og utløper etter et begrenset tidsvindu.

​
Feilsvar

Endepunktet returnerer HTTP 400 når et påkrevd felt mangler, en verdi faller utenfor det tillatte området, eller input_reference sendes til en modell som ikke støtter image-to-video. Det returnerer HTTP 401 når bearer-token mangler eller er ugyldig. Feilkroppen bruker én av to former; se 400- og 401-eksemplene i playground for de nøyaktige feltene.

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.

Eksempel:

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

​
model
enum<string>
påkrevd

Seedance model id. Choose doubao-seedance-2-0 for the highest quality 2.0 output, doubao-seedance-2-0-fast for quick iteration on 2.0, doubao-seedance-1-5-pro for the 1.5 Pro tier, or doubao-seedance-1-0-pro for the 1.0 Pro tier. Only the two 2.0 models accept input_reference.

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

"doubao-seedance-2-0-fast"

​
seconds
integer
standard:5

Video duration in seconds. The accepted range depends on the model: doubao-seedance-2-0 and doubao-seedance-2-0-fast accept 4 to 15, doubao-seedance-1-5-pro accepts 4 to 12, and doubao-seedance-1-0-pro accepts 2 to 10. The default is 5 for every model.

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

5

​
size
enum<string>
standard:16:9

Output aspect ratio. All Seedance models accept the same set of values.

Tilgjengelige alternativer:
21:9,
16:9,
4:3,
1:1,
3:4,
9:16
Eksempel:

"16:9"

​
resolution
enum<string>
standard:720p

Output resolution. 480p and 720p are accepted by every model; 1080p is supported only by doubao-seedance-1-5-pro and doubao-seedance-1-0-pro.

Tilgjengelige alternativer:
480p,
720p,
1080p
Eksempel:

"720p"

​
input_reference
file

Optional reference image. When included, the job runs in image-to-video mode and uses the image as the visual anchor. Only doubao-seedance-2-0 and doubao-seedance-2-0-fast accept this field; sending it with a 1.0 Pro or 1.5 Pro model returns HTTP 400.

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. A newly created task is returned as SUBMITTED.

Tilgjengelige alternativer:
SUBMITTED,
IN_PROGRESS,
SUCCESS,
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.