Een Wan-video maken

Maak een Wan-video van tekst, referentiemedia of eerste en laatste frames. Sla de geretourneerde id op om de taakstatus op te vragen en de voltooide video te downloaden. POST /v1/videos gebruikt multipart/form-data. Verzend een expliciete gehele seconds-waarde en een size in de vorm WxH.

Een invoermodus kiezen

Elke modus vereist model en prompt. De beschikbare media-invoer is afhankelijk van het model:

Doel	Model-ID’s	Mediavelden
Tekst-naar-video	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Mediavelden weglaten
Afbeelding-naar-video	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL’s of geüploade afbeeldingsbestanden
Referentievideo	`wan2.6`	`reference_videos` alleen
Afbeeldings- en videoreferenties	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` met `reference_videos`
Afbeeldings-, video- en audioreferenties	`wan3.0`, `wan3.0-prime`	Afbeeldings-/videoreferenties met `reference_audios`
Eerste en laatste frames	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, optioneel `last_frame`

Gebruik het volgende om een Wan-model-ID te vinden die beschikbaar is voor je API-sleutel: Beschikbare modellen weergeven.

Referentieafbeeldingen gebruiken

Verzend voor wan2.7, wan3.0 en wan3.0-prime referentieafbeeldingen via input_reference als openbaar toegankelijke HTTPS-URL’s of geüploade bestanden. Herhaal bij meerdere afbeeldingen het veld in afbeeldingsvolgorde, met één URL of bestand per veld. Gebruik binnen input_reference uitsluitend URL’s of uitsluitend bestanden. Verzend elke URL afzonderlijk in plaats van URL’s te combineren in een door komma’s gescheiden waarde. Gebruik PNG- of JPEG-afbeeldingen van maximaal 20 MB per afbeelding. Eén input_reference-URL of -bestand gebruikt de afbeelding-naar-video-workflow. De afbeelding stuurt de compositie en het uiterlijk; gebruik de prompt om beweging en cameragedrag te beschrijven. Verzend voor wan3.0 en wan3.0-prime maximaal 10 referentieafbeeldingen via input_reference, ongeacht of je URL’s of geüploade bestanden gebruikt.

Referentievideo’s en audio gebruiken

Verstuur video’s via reference_videos en audioclips via reference_audios, waarbij je elk veld eenmaal per invoer herhaalt. Elke invoer kan een openbaar toegankelijke HTTPS-URL of een geüpload bestand zijn. Gebruik MP4-bestanden met H.264-gecodeerde video voor videoreferenties. Gebruik afzonderlijke MP3-bestanden voor audioreferenties. Verschillende velden kunnen verschillende invoertypen gebruiken, zoals een afbeeldings-URL met geüploade video’s. Gebruik binnen reference_videos of reference_audios uitsluitend URL’s of uitsluitend bestanden. Je kunt maximaal vijf videobestanden uploaden, elk maximaal 50 MiB (50 × 1024 × 1024 bytes). Je kunt maximaal vijf audiobestanden uploaden, elk maximaal 15 MiB (15 × 1024 × 1024 bytes).

Wan 2.6-videoreferenties

Verstuur één tot drie reference_videos, elk 2–30 seconden, maximaal 30 MB en minstens 16 fps. Deze limieten gelden voor zowel URL’s als geüploade video’s. Verwijs in de prompt naar onderwerpen als @Video1, @Video2 en @Video3 in invoervolgorde. Laat voor deze modus input_reference, reference_audios, first_frame en last_frame weg. Stel seconds in op 5 of 10. Deze voorbeelden maken een video van vijf seconden op basis van twee videoreferenties. Vervang de media-URL’s of bestandsnamen door je invoer:

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-afbeeldings- en videoreferenties

Combineer afbeeldings- en videoreferenties om het uiterlijk en de beweging van onderwerpen te sturen. Stel seconds in op een geheel getal van 2 tot en met 10. Laat reference_audios weg. Gebruik twee afbeeldings-URL’s of twee geüploade afbeeldingen met een videoreferentie:

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-afbeeldings-, video- en audioreferenties

Combineer voor wan3.0 en wan3.0-prime afbeeldings- en videoreferenties met audioreferenties om uiterlijk, beweging en ritme te sturen. Verstuur maximaal vijf videoreferenties met een gezamenlijke duur van maximaal 15 seconden. Elke video moet minstens 16 fps zijn. Verstuur maximaal vijf audioreferenties met een gezamenlijke duur van maximaal 15 seconden. Tel de duur van video en audio afzonderlijk. Stel de uitvoerwaarde seconds in op een geheel getal van 2 tot en met 30. Gebruik twee afbeeldings-URL’s of twee geüploade afbeeldingen met één video en twee audioclips:

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'

Gebruik eerste en laatste frames

Stuur voor wan2.7, wan3.0 en wan3.0-prime first_frame voor de openingsafbeelding en optioneel last_frame voor de eindafbeelding. Elk veld accepteert één openbaar toegankelijke HTTPS-PNG- of JPEG-URL of één geüpload PNG- of JPEG-bestand. Voor frame-invoer van Wan 2.7 bepaalt de openingsafbeelding de beeldverhouding, terwijl size de uitvoerresolutielaag selecteert. Dien frame-invoer in via een afzonderlijk verzoek, los van input_reference, reference_videos en reference_audios. Deze Wan 2.7-voorbeelden maken een overgang tussen openings- en eindframes:

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'

Deze Wan 3.0-voorbeelden maken een overgang tussen openings- en eindframes:

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'

Duur en grootte instellen

Verstuur seconds als een geheel getal binnen het bereik voor uw model en invoermodus.

Model-ID	Invoermodus	`seconds`	Standaard
`wan3.0`, `wan3.0-prime`	Tekst, referenties of frames	geheel getal `2`–`30`	`5` seconden, `1920x1080`
`wan2.7`	Tekst	geheel getal `2`–`15`	`5` seconden, `1920x1080`
`wan2.7`	Frames	geheel getal `2`–`15`	`5` seconden, `1080p`-niveau; de beeldverhouding volgt de openingsafbeelding
`wan2.7`	Afbeeldings-/videoreferenties	geheel getal `2`–`10`	`5` seconden, `1920x1080`
`wan2.6`	Tekst	`5`, `10`, `15`	`5` seconden, `1920x1080`
`wan2.6`	Videoreferenties	`5`, `10`	`5` seconden, `1920x1080`

Stel size in op een van de onderstaande WxH-waarden voor het doelmodel. De groottewaarden van Wan 3.0 gelden ook voor wan3.0-prime.

Groottewaarden van Wan 3.0

Resolutieniveau	Beeldverhouding	`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`

Groottewaarden van Wan 2.7

Resolutieniveau	Beeldverhouding	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Groottewaarden van Wan 2.6

Resolutieniveau	Beeldverhouding	`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`

Taakstroom

De taak maken

Verstuur de multipartformulieraanvraag en sla de geretourneerde id op.

De taakstatus controleren

Roep Een Wan-video ophalen aan totdat status de waarde completed, failed of error heeft.

Het resultaat downloaden

Wanneer de taak de status completed heeft, roept u Wan-video-inhoud ophalen aan om het MP4-bestand te downloaden.

Autorisaties

Authorization

string

header

vereist

Bearer authentication. Use your CometAPI API key.

Body

multipart/form-data

model

string

vereist

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.

Voorbeeld:

"wan3.0"

prompt

string

vereist

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.

Voorbeeld:

"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.

Vereist bereik: 2 <= x <= 30

Voorbeeld:

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.

Voorbeeld:

"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://

Respons

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

string

vereist

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

Voorbeeld:

"task_example"

object

string

vereist

Object type. Video tasks return video.

Voorbeeld:

"video"

model

string

vereist

Model ID used for the task.

Voorbeeld:

"wan3.0"

status

enum<string>

vereist

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

Beschikbare opties:

queued,

in_progress,

completed,

failed,

error

Voorbeeld:

"queued"

progress

integer

vereist

Task progress as a coarse percentage.

Vereist bereik: 0 <= x <= 100

Voorbeeld:

0

created_at

integer

vereist

Task creation time as a Unix timestamp in seconds.

Voorbeeld:

1779938152

task_id

string

Compatibility alias for id when present.

Voorbeeld:

"task_example"

completed_at

integer

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

Voorbeeld:

1779938219

video_url

string

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

Voorbeeld:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Contentmoderatie

API-sleutels

Een invoermodus kiezen

Referentieafbeeldingen gebruiken

Referentievideo’s en audio gebruiken

Wan 2.6-videoreferenties

Wan 2.7-afbeeldings- en videoreferenties

Wan 3.0-afbeeldings-, video- en audioreferenties

Gebruik eerste en laatste frames

Duur en grootte instellen

Groottewaarden van Wan 3.0

Groottewaarden van Wan 2.7

Groottewaarden van Wan 2.6

Taakstroom

Autorisaties

Body

Respons

​Een invoermodus kiezen

​Referentieafbeeldingen gebruiken

​Referentievideo’s en audio gebruiken

​Wan 2.6-videoreferenties

​Wan 2.7-afbeeldings- en videoreferenties

​Wan 3.0-afbeeldings-, video- en audioreferenties

​Gebruik eerste en laatste frames

​Duur en grootte instellen

​Groottewaarden van Wan 3.0

​Groottewaarden van Wan 2.7

​Groottewaarden van Wan 2.6

​Taakstroom

Autorisaties

Body

Respons

Een invoermodus kiezen

Referentieafbeeldingen gebruiken

Referentievideo’s en audio gebruiken

Wan 2.6-videoreferenties

Wan 2.7-afbeeldings- en videoreferenties

Wan 3.0-afbeeldings-, video- en audioreferenties

Gebruik eerste en laatste frames

Duur en grootte instellen

Groottewaarden van Wan 3.0

Groottewaarden van Wan 2.7

Groottewaarden van Wan 2.6

Taakstroom