Opprett en Wan-video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Opprett en Wan-video fra tekst, referansemedier eller første og siste bilder. Lagre den returnerte id for å hente oppgavestatusen og laste ned den fullførte videoen. POST /v1/videos bruker multipart/form-data. Send en eksplisitt heltallsverdi for seconds og en size i WxH-format.

Velg en inndatamodus

Alle moduser krever model og prompt. Tilgjengelige medieinnganger avhenger av modellen:

Mål	Modell-ID-er	Mediefelter
Tekst-til-video	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Utelat mediefelter
Bilde-til-video	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL-er eller opplastede bildefiler
Referansevideo	`wan2.6`	`reference_videos` kun
Bilde- og videoreferanser	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` med `reference_videos`
Bilde-, video- og lydreferanser	`wan3.0`, `wan3.0-prime`	Bilde-/videoreferanser med `reference_audios`
Første og siste bilder	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, valgfritt `last_frame`

For å finne en Wan-modell-ID som er tilgjengelig for API-nøkkelen din, bruker du List tilgjengelige modeller.

Bruk referansebilder

For wan2.7, wan3.0 og wan3.0-prime sender du referansebilder via input_reference som offentlig tilgjengelige HTTPS-URL-er eller opplastede filer. For flere bilder gjentar du feltet i bilderekkefølge, med én URL eller fil per felt. Bruk enten bare URL-er eller bare filer i input_reference. Send hver URL separat i stedet for å kombinere URL-er i en kommaseparert verdi. Bruk PNG- eller JPEG-bilder på opptil 20 MB hver. Én enkelt input_reference-URL eller -fil bruker arbeidsflyten for bilde-til-video. Bildet styrer komposisjon og utseende; bruk prompten til å beskrive bevegelse og kamerabevegelser. For wan3.0 og wan3.0-prime sender du maksimalt 10 referansebilder via input_reference, enten du bruker URL-er eller opplastede filer.

Bruk referansevideoer og lyd

Send videoer via reference_videos og lydklipp via reference_audios, og gjenta hvert felt én gang per inndata. Hver inndata kan være en offentlig tilgjengelig HTTPS-URL eller en opplastet fil. Bruk MP4-filer med H.264-kodet video som videoreferanser. Bruk separate MP3-filer som lydreferanser. Ulike felt kan bruke ulike inndatatyper, for eksempel en bilde-URL sammen med opplastede videoer. I reference_videos eller reference_audios bruker du enten bare URL-er eller bare filer. Du kan laste opp opptil fem videofiler, hver på maksimalt 50 MiB (50 × 1024 × 1024 byte). Du kan laste opp opptil fem lydfiler, hver på maksimalt 15 MiB (15 × 1024 × 1024 byte).

Wan 2.6-videoreferanser

Send én til tre reference_videos, hver på 2–30 sekunder, opptil 30 MB og med minst 16 fps. Disse grensene gjelder både URL-er og opplastede videoer. I Prompt refererer du til motiver som @Video1, @Video2 og @Video3 i inndatarekkefølge. For denne modusen utelater du input_reference, reference_audios, first_frame og last_frame. Sett seconds til 5 eller 10. Disse eksemplene oppretter en fem sekunder lang video fra to videoreferanser. Erstatt medie-URL-ene eller filnavnene med inndataene dine:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=https://your-media-host/reference-1.mp4' \
  -F 'reference_videos=https://your-media-host/reference-2.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.6' \
  --form-string 'prompt=Keep @Video1 and @Video2 recognizable as they walk.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'reference_videos=@reference-1.mp4;type=video/mp4' \
  -F 'reference_videos=@reference-2.mp4;type=video/mp4'

Wan 2.7-bilde- og videoreferanser

Kombiner bilde- og videoreferanser for å styre motivets utseende og bevegelse. Sett seconds til et heltall fra 2 til og med 10. Utelat reference_audios. Bruk to bilde-URL-er eller to opplastede bilder med en videoreferanse:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Preserve the image subjects and follow the video motion.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4'

Wan 3.0-bilde-, video- og lydreferanser

For wan3.0 og wan3.0-prime kombinerer du bilde- og videoreferanser med lydreferanser for å styre utseende, bevegelse og rytme. Send maksimalt fem videoreferanser med en samlet varighet på maksimalt 15 sekunder. Hver video må ha minst 16 fps. Send maksimalt fem lydreferanser med en samlet varighet på maksimalt 15 sekunder. Tell video- og lydvarighet hver for seg. Sett seconds for utdata til et heltall fra 2 til og med 30. Bruk to bilde-URL-er eller to opplastede bilder med én video og to lydklipp:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=https://your-image-host/reference-1.png' \
  -F 'input_reference=https://your-image-host/reference-2.jpg' \
  -F 'reference_videos=https://your-media-host/reference.mp4' \
  -F 'reference_audios=https://your-media-host/reference-1.mp3' \
  -F 'reference_audios=https://your-media-host/reference-2.mp3'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Preserve image subjects, video motion, and audio rhythm.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'input_reference=@reference-1.png;type=image/png' \
  -F 'input_reference=@reference-2.jpg;type=image/jpeg' \
  -F 'reference_videos=@reference.mp4;type=video/mp4' \
  -F 'reference_audios=@reference-1.mp3;type=audio/mpeg' \
  -F 'reference_audios=@reference-2.mp3;type=audio/mpeg'

Bruk første og siste bilde

For wan2.7, wan3.0 og wan3.0-prime sender du first_frame for startbildet og eventuelt last_frame for sluttbildet. Hvert felt godtar én offentlig tilgjengelig HTTPS-URL til en PNG- eller JPEG-fil, eller én opplastet PNG- eller JPEG-fil. For rammainndata i Wan 2.7 bestemmer startbildet sideforholdet, mens size velger nivået for utdataoppløsning. Send rammainndata i en separat forespørsel fra input_reference, reference_videos og reference_audios. Disse Wan 2.7-eksemplene oppretter en overgang mellom start- og sluttrammer:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan2.7' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Disse Wan 3.0-eksemplene oppretter en overgang mellom start- og sluttrammer:

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=https://your-image-host/first-frame.png' \
  -F 'last_frame=https://your-image-host/last-frame.jpg'

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F 'model=wan3.0' \
  -F 'prompt=Move smoothly from the opening frame to the ending frame.' \
  -F 'seconds=5' \
  -F 'size=1280x720' \
  -F 'first_frame=@first-frame.png;type=image/png' \
  -F 'last_frame=@last-frame.jpg;type=image/jpeg'

Angi varighet og størrelse

Send seconds som et heltall innenfor området som gjelder for modellen og inndatamodusen.

Modell-ID	Inndatamodus	`seconds`	Standard
`wan3.0`, `wan3.0-prime`	Tekst, referanser eller bilder	heltall `2`–`30`	`5` sekunder, `1920x1080`
`wan2.7`	Tekst	heltall `2`–`15`	`5` sekunder, `1920x1080`
`wan2.7`	Bilder	heltall `2`–`15`	`5` sekunder, `1080p`-nivå; sideforholdet følger åpningsbildet
`wan2.7`	Bilde-/videoreferanser	heltall `2`–`10`	`5` sekunder, `1920x1080`
`wan2.6`	Tekst	`5`, `10`, `15`	`5` sekunder, `1920x1080`
`wan2.6`	Videoreferanser	`5`, `10`	`5` sekunder, `1920x1080`

Angi size til én av WxH-verdiene nedenfor for målmodellen. Størrelsesverdiene for Wan 3.0 gjelder også for wan3.0-prime.

Størrelsesverdier for Wan 3.0

Oppløsningsnivå	Sideforhold	`size` (`WxH`)
`480p`	`16:9`	`832x480`
	`9:16`	`480x832`
	`1:1`	`624x624`
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`1:1`	`960x960`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Størrelsesverdier for Wan 2.7

Oppløsningsnivå	Sideforhold	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Størrelsesverdier for Wan 2.6

Oppløsningsnivå	Sideforhold	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
	`4:3`	`1088x832`
	`3:4`	`832x1088`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`
	`4:3`	`1632x1248`
	`3:4`	`1248x1632`

Oppgaveflyt

Opprett oppgaven

Send multipart-skjemaanmodningen og lagre den returnerte id.

Sjekk oppgaven jevnlig

Kall Hent en Wan-video til status er completed, failed eller error.

Last ned resultatet

Når oppgaven har status completed, kall Hent Wan-videoinnhold for å laste ned MP4-filen.

Autorisasjoner

Authorization

string

header

påkrevd

Bearer authentication. Use your CometAPI API key.

Kropp

multipart/form-data

model

string

påkrevd

Wan model ID: wan2.6, wan2.7, wan3.0, or wan3.0-prime. Use wan2.6 for text or reference-video input. Use wan2.7 for text, image/video references, or frame inputs. Use wan3.0 or wan3.0-prime to also include reference audio.

Eksempel:

"wan3.0"

prompt

string

påkrevd

Text prompt that describes the video to generate. Describe the appearance and motion to preserve from references, or the transition between first_frame and last_frame. For wan2.6 video references, use @Video1, @Video2, and @Video3 in input order.

Eksempel:

"A small robot walks through a bright greenhouse with smooth camera movement."

seconds

integer

Requested output duration in whole seconds. Send an explicit integer. For wan2.6 reference-to-video, use 5 or 10; text-to-video also accepts 15. For wan2.7 reference-to-video, use 2 through 10; text and frame inputs accept 2 through 15. For wan3.0 and wan3.0-prime, use 2 through 30. Default is 5.

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

Eksempel:

5

size

string

Supported WxH size values. For wan3.0 and wan3.0-prime: 832x480, 480x832, 624x624, 640x480, 480x640, 1280x720, 720x1280, 960x960, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.6: 1280x720, 720x1280, 1088x832, 832x1088, 1920x1080, 1080x1920, 1440x1440, 1632x1248, 1248x1632. For wan2.7: 1280x720, 720x1280, 1920x1080, 1080x1920, 1440x1440. Default is 1920x1080. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Eksempel:

"1920x1080"

input_reference

PNG or JPEG reference images for wan2.7, wan3.0, and wan3.0-prime. Repeat input_reference with one publicly accessible HTTPS image URL or uploaded image file per field. Use all URLs or all files within this field. Do not combine URLs into a comma-separated value. A single URL or file uses the image-to-video workflow. Each image can be up to 20 MB. For wan3.0 and wan3.0-prime, send at most 10 reference images, whether you use URLs or uploaded files. Image and video references can share a request; reference audio requires wan3.0 or wan3.0-prime. Submit frame inputs separately. Omit for text-to-video and wan2.6 reference-to-video. Submit images in the order you want to reference them in the prompt.

Pattern: ^https://

reference_videos

(string<uri> | file)[]

Reference videos for wan2.6, wan2.7, wan3.0, and wan3.0-prime. Repeat reference_videos with publicly accessible HTTPS URLs or uploaded MP4 files with H.264 video. Use one input type within this field: all URLs or all files. For wan2.6, send 1 to 3 clips, each 2 to 30 seconds and up to 30 MB, with at least 16 fps; omit image, audio, and frame fields. For wan2.7, combine video references with image references. For wan3.0 and wan3.0-prime, send at most 5 clips totaling at most 15 seconds, with at least 16 fps. Video uploads are limited to 5 files, each at most 50 MiB (50 x 1024 x 1024 bytes); the lower wan2.6 limits still apply. Submit frame inputs separately.

Minimum array length: 1

Pattern: ^https://

reference_audios

(string<uri> | file)[]

Reference audio for wan3.0 and wan3.0-prime, combined with image or video references. Repeat reference_audios with publicly accessible HTTPS MP3 URLs or uploaded MP3 files. Use one input type within this field: all URLs or all files. Send at most 5 audio references totaling at most 15 seconds, counted separately from reference video duration. Audio uploads are limited to 5 files, each at most 15 MiB (15 x 1024 x 1024 bytes). Submit frame inputs separately. Omit for wan2.6 and wan2.7.

Minimum array length: 1

Pattern: ^https://

first_frame

Opening frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use first_frame alone or add last_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

last_frame

Ending frame for wan2.7, wan3.0, and wan3.0-prime, as one publicly accessible HTTPS PNG or JPEG URL or one uploaded PNG or JPEG file. Use with first_frame to guide the ending. Submit frame inputs in a separate request from input_reference, reference_videos, and reference_audios. Omit for wan2.6. For Wan 2.7 frame inputs, the opening image determines the aspect ratio; size selects the output resolution tier.

Pattern: ^https://

Svar

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

string

påkrevd

Task ID. Use this value with retrieve and content endpoints.

Eksempel:

"task_example"

object

string

påkrevd

Object type. Video tasks return video.

Eksempel:

"video"

model

string

påkrevd

Model ID used for the task.

Eksempel:

"wan3.0"

status

enum<string>

påkrevd

Task lifecycle status. Poll until the value is completed, failed, or error.

Tilgjengelige alternativer:

queued,

in_progress,

completed,

failed,

error

Eksempel:

"queued"

progress

integer

påkrevd

Task progress as a coarse percentage.

Nødvendig område: 0 <= x <= 100

Eksempel:

0

created_at

integer

påkrevd

Task creation time as a Unix timestamp in seconds.

Eksempel:

1779938152

task_id

string

Compatibility alias for id when present.

Eksempel:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Eksempel:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Eksempel:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Sist endret 9. september 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=wan3.0 \
  -F 'prompt=A small robot walks through a bright greenhouse with smooth camera movement.' \
  -F seconds=5 \
  -F size=1920x1080

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "wan3.0",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Innholdsmoderering

API-nøkler

Velg en inndatamodus

Bruk referansebilder

Bruk referansevideoer og lyd

Wan 2.6-videoreferanser

Wan 2.7-bilde- og videoreferanser

Wan 3.0-bilde-, video- og lydreferanser

Bruk første og siste bilde

Angi varighet og størrelse

Størrelsesverdier for Wan 3.0

Størrelsesverdier for Wan 2.7

Størrelsesverdier for Wan 2.6

Oppgaveflyt

Autorisasjoner

Kropp

Svar

​Velg en inndatamodus

​Bruk referansebilder

​Bruk referansevideoer og lyd

​Wan 2.6-videoreferanser

​Wan 2.7-bilde- og videoreferanser

​Wan 3.0-bilde-, video- og lydreferanser

​Bruk første og siste bilde

​Angi varighet og størrelse

​Størrelsesverdier for Wan 3.0

​Størrelsesverdier for Wan 2.7

​Størrelsesverdier for Wan 2.6

​Oppgaveflyt

Autorisasjoner

Kropp

Svar

Velg en inndatamodus

Bruk referansebilder

Bruk referansevideoer og lyd

Wan 2.6-videoreferanser

Wan 2.7-bilde- og videoreferanser

Wan 3.0-bilde-, video- og lydreferanser

Bruk første og siste bilde

Angi varighet og størrelse

Størrelsesverdier for Wan 3.0

Størrelsesverdier for Wan 2.7

Størrelsesverdier for Wan 2.6

Oppgaveflyt