Wan videosu oluşturun

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
}

Metinden, referans medyadan veya ilk ve son karelerden bir Wan videosu oluşturun. Görevi yoklamak ve tamamlanan videoyu indirmek için döndürülen id değerini saklayın. POST /v1/videos multipart/form-data kullanır. Açık bir tamsayı seconds değeri ve size biçiminde bir WxH gönderin.

Bir giriş modu seçin

Her mod model ve prompt gerektirir. Kullanılabilir medya girdileri modele bağlıdır:

Amaç	Model ID’leri	Medya alanları
Metinden videoya	`wan2.6`, `wan2.7`, `wan3.0`, `wan3.0-prime`	Medya alanlarını atlayın
Görüntüden videoya	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` URL’ler veya yüklenmiş görüntü dosyaları
Referans video	`wan2.6`	`reference_videos` yalnızca
Görüntü ve video referansları	`wan2.7`, `wan3.0`, `wan3.0-prime`	`input_reference` ile `reference_videos`
Görüntü, video ve ses referansları	`wan3.0`, `wan3.0-prime`	Şunları içeren görüntü/video referansları: `reference_audios`
İlk ve son kareler	`wan2.7`, `wan3.0`, `wan3.0-prime`	`first_frame`, isteğe bağlı olarak `last_frame`

API anahtarınız için kullanılabilir bir Wan model ID’si bulmak üzere şunu kullanın Kullanılabilir modelleri listeleyin.

Referans görüntüler kullanın

wan2.7, wan3.0 ve wan3.0-prime için, referans görüntüleri herkese açık HTTPS URL’leri veya yüklenmiş dosyalar olarak input_reference aracılığıyla gönderin. Birden fazla görüntü için alanı görüntü sırasıyla tekrarlayın; her alan için bir URL veya dosya kullanın. input_reference içinde ya tüm URL’leri ya da tüm dosyaları kullanın. URL’leri virgülle ayrılmış tek bir değerde birleştirmek yerine her URL’yi ayrı gönderin. Her biri en fazla 20 MB olan PNG veya JPEG görüntüleri kullanın. Tek bir input_reference URL’si veya dosyası, görüntüden videoya iş akışını kullanır. Görüntü kompozisyonu ve görünümü yönlendirir; hareketi ve kamera davranışını açıklamak için prompt’u kullanın. wan3.0 ve wan3.0-prime için, URL’ler veya yüklenmiş dosyalar kullanmanızdan bağımsız olarak input_reference aracılığıyla en fazla 10 referans görüntüsü gönderin.

Referans videoları ve sesleri kullanma

Videoları reference_videos üzerinden, ses kliplerini ise reference_audios üzerinden gönderin; her giriş için her alanı bir kez tekrarlayın. Her giriş, herkese açık bir HTTPS URL’si veya yüklenmiş bir dosya olabilir. Video referansları için H.264 ile kodlanmış video içeren MP4 dosyalarını kullanın. Ses referansları için ayrı MP3 dosyaları kullanın. Farklı alanlar, yüklenmiş videolarla birlikte bir görüntü URL’si gibi farklı giriş türlerini kullanabilir. reference_videos veya reference_audios içinde, ya yalnızca URL’ler ya da yalnızca dosyalar kullanın. Her biri en fazla 50 MiB (50 × 1024 × 1024 bayt olan en fazla beş video dosyası yükleyebilirsiniz). Her biri en fazla 15 MiB (15 × 1024 × 1024 bayt olan en fazla beş ses dosyası yükleyebilirsiniz).

Wan 2.6 video referansları

Her biri 2–30 saniye uzunluğunda, en fazla 30 MB ve en az 16 fps olan bir ila üç reference_videos gönderin. Bu sınırlar hem URL’ler hem de yüklenmiş videolar için geçerlidir. Prompt içinde, konulara giriş sırasıyla @Video1, @Video2 ve @Video3 olarak başvurun. Bu mod için input_reference, reference_audios, first_frame ve last_frame değerlerini atlayın. seconds değerini 5 veya 10 olarak ayarlayın. Bu örnekler, iki video referansından beş saniyelik bir video oluşturur. Medya URL’lerini veya dosya adlarını kendi girişlerinizle değiştirin:

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 görüntü ve video referansları

Konu görünümünü ve hareketini yönlendirmek için görüntü ve video referanslarını birleştirin. seconds değerini 2 ile 10 arasında bir tamsayı olarak ayarlayın. reference_audios değerini atlayın. Bir video referansıyla birlikte iki görüntü URL’si veya iki yüklenmiş görüntü kullanın:

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 görüntü, video ve ses referansları

wan3.0 ve wan3.0-prime için görünümü, hareketi ve ritmi yönlendirmek üzere görüntü ve video referanslarını ses referanslarıyla birleştirin. Toplam süresi en fazla 15 saniye olan en fazla beş video referansı gönderin. Her video en az 16 fps olmalıdır. Toplam süresi en fazla 15 saniye olan en fazla beş ses referansı gönderin. Video ve ses sürelerini ayrı ayrı hesaplayın. Çıktı seconds değerini 2 ile 30 arasında bir tamsayı olarak ayarlayın. Bir video ve iki ses klibiyle birlikte iki görüntü URL’si veya iki yüklenmiş görüntü kullanın:

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'

İlk ve son kareleri kullanın

wan2.7, wan3.0 ve wan3.0-prime için, açılış görüntüsü olarak first_frame öğesini, bitiş görüntüsü olarak ise isteğe bağlı biçimde last_frame öğesini gönderin. Her alan, herkese açık olarak erişilebilen bir HTTPS PNG veya JPEG URL’sini ya da yüklenmiş bir PNG veya JPEG dosyasını kabul eder. Wan 2.7 kare girdilerinde açılış görüntüsü en-boy oranını belirlerken, size çıktı çözünürlük katmanını seçer. Kare girdilerini input_reference, reference_videos ve reference_audios öğelerinden ayrı bir istekte gönderin. Bu Wan 2.7 örnekleri, açılış ve bitiş kareleri arasında bir geçiş oluşturur:

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'

Bu Wan 3.0 örnekleri, açılış ve bitiş kareleri arasında bir geçiş oluşturur:

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'

Süreyi ve boyutu ayarlama

seconds değerini, modeliniz ve giriş modunuz için geçerli aralıkta bir tam sayı olarak gönderin.

Model ID	Giriş modu	`seconds`	Varsayılan
`wan3.0`, `wan3.0-prime`	Metin, referanslar veya kareler	tam sayı `2`–`30`	`5` saniye, `1920x1080`
`wan2.7`	Metin	tam sayı `2`–`15`	`5` saniye, `1920x1080`
`wan2.7`	Kareler	tam sayı `2`–`15`	`5` saniye, `1080p` katmanı; en-boy oranı başlangıç görüntüsünü izler
`wan2.7`	Görüntü/video referansları	tam sayı `2`–`10`	`5` saniye, `1920x1080`
`wan2.6`	Metin	`5`, `10`, `15`	`5` saniye, `1920x1080`
`wan2.6`	Video referansları	`5`, `10`	`5` saniye, `1920x1080`

size değerini, hedef model için aşağıdaki WxH değerlerinden biri olarak ayarlayın. Wan 3.0 boyut değerleri wan3.0-prime için de geçerlidir.

Wan 3.0 boyut değerleri

Çözünürlük katmanı	En-boy oranı	`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`

Wan 2.7 boyut değerleri

Çözünürlük katmanı	En-boy oranı	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
	`9:16`	`1080x1920`
	`1:1`	`1440x1440`

Wan 2.6 boyut değerleri

Çözünürlük katmanı	En-boy oranı	`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`

Görev akışı

Görevi oluşturun

Çok parçalı form isteğini gönderin ve döndürülen id değerini saklayın.

Görevi sorgulayın

Şu Wan videosunu alma işlemini, status değeri completed, failed veya error olana kadar çağırın.

Sonucu indirin

Görev completed olduğunda, Wan video içeriğini alma işlemini çağırarak MP4 dosyasını indirin.

Yetkilendirmeler

Authorization

string

header

gerekli

Bearer authentication. Use your CometAPI API key.

Gövde

multipart/form-data

model

string

gerekli

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.

Örnek:

"wan3.0"

prompt

string

gerekli

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.

Örnek:

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

Gerekli aralık: 2 <= x <= 30

Örnek:

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.

Örnek:

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

Yanıt

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

string

gerekli

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

Örnek:

"task_example"

object

string

gerekli

Object type. Video tasks return video.

Örnek:

"video"

model

string

gerekli

Model ID used for the task.

Örnek:

"wan3.0"

status

enum<string>

gerekli

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

Mevcut seçenekler:

queued,

in_progress,

completed,

failed,

error

Örnek:

"queued"

progress

integer

gerekli

Task progress as a coarse percentage.

Gerekli aralık: 0 <= x <= 100

Örnek:

0

created_at

integer

gerekli

Task creation time as a Unix timestamp in seconds.

Örnek:

1779938152

task_id

string

Compatibility alias for id when present.

Örnek:

"task_example"

completed_at

integer

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

Örnek:

1779938219

video_url

string

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

Örnek:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Son değiştirilme tarihi 9 Eylül 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
}

İçerik moderasyonu

API anahtarları

Bir giriş modu seçin

Referans görüntüler kullanın

Referans videoları ve sesleri kullanma

Wan 2.6 video referansları

Wan 2.7 görüntü ve video referansları

Wan 3.0 görüntü, video ve ses referansları

İlk ve son kareleri kullanın

Süreyi ve boyutu ayarlama

Wan 3.0 boyut değerleri

Wan 2.7 boyut değerleri

Wan 2.6 boyut değerleri

Görev akışı

Yetkilendirmeler

Gövde

Yanıt

​Bir giriş modu seçin

​Referans görüntüler kullanın

​Referans videoları ve sesleri kullanma

​Wan 2.6 video referansları

​Wan 2.7 görüntü ve video referansları

​Wan 3.0 görüntü, video ve ses referansları

​İlk ve son kareleri kullanın

​Süreyi ve boyutu ayarlama

​Wan 3.0 boyut değerleri

​Wan 2.7 boyut değerleri

​Wan 2.6 boyut değerleri

​Görev akışı

Yetkilendirmeler

Gövde

Yanıt

Bir giriş modu seçin

Referans görüntüler kullanın

Referans videoları ve sesleri kullanma

Wan 2.6 video referansları

Wan 2.7 görüntü ve video referansları

Wan 3.0 görüntü, video ve ses referansları

İlk ve son kareleri kullanın

Süreyi ve boyutu ayarlama

Wan 3.0 boyut değerleri

Wan 2.7 boyut değerleri

Wan 2.6 boyut değerleri

Görev akışı