Wan 3.0 Video Prime API

wan3.0-video-prime modelini APIMaster eşzamansız video API'si üzerinden kullanın. Mevcut entegrasyon 480P / 720P / 1080P, 2–30 tam sayı saniye ve görev başına bir video sunar. Parametre ve entegrasyon incelemesi: 2026-10-26.

Uç noktalar ve kimlik doğrulama

İşlem	Yöntem ve URL
Oluştur	POST https://apimaster.ai/v1/videos
Sorgula	GET https://apimaster.ai/v1/videos/{task_id}
İndir	GET https://apimaster.ai/v1/videos/{task_id}/content

Her istekte Authorization: Bearer YOUR_API_KEY ve görev oluştururken Content-Type: application/json kullanın. Alibaba Cloud anahtarı değil, APIMaster API anahtarı kullanın. APIMaster üst kaynak eşzamansız başlığını sağlar; X-DashScope-Async kullanmanıza gerek yoktur.

Uyumlu oluşturma uç noktası /videos/generations farklı bir yanıt zarfı döndürür; aşağıdaki örnekler tutarlı biçimde /videos kullanır.

Mevcut rota yetenekleri

Bu modeli şu anda iki entegrasyon sunmaktadır: Alibaba Cloud yerel rotası ve GMI rotası. Gelişmiş alanlar ilgili rotayı gerektirir; bir alanın gönderilmesi o rotayı seçmez. Rotaya özgü örnekleri kullanmadan önce API anahtarınızın hangi rotaya erişebildiğini doğrulayın.

Yetenek	Alibaba Cloud yerel	GMI
Metinden videoya, ilk kare, ilk/son kareler, referans görseller	Entegre	Entegre, farklı medya alanlarıyla
Referans ses	metadata.input.media	audio_url
Belge / herkese açık web sayfası	Yerel medya alanları iletilir; tamamlanan üretim kontrolü kapsamında değildir	Desteklenmez
Referans video, düzenleme, uzatma	Gönderimden önce engellenir	Desteklenmez
Otomatik süre -1	Engellenir	Engellenir
En-boy oranı 21:9	Kabul edilir	Reddedilir
Açık ses anahtarı	generate_audio / audio	Desteklenmez; bu alanları atlayın
İstem yeniden yazımını devre dışı bırakma / sabit tohum 0	Mevcut serileştirme prompt_extend: false veya seed: 0 değerlerini korumaz; bunlara güvenmeyin	Açık false ve 0 korunur

Yerel rotada 5 saniyelik 720P sessiz bir video, 2026-10-24 kabul kontrolünde başarıyla tamamlandı, indirildi ve çözüldü. Diğer medya kombinasyonları, üretim testinden geçmiş kombinasyonlar olarak sunulmak yerine bağdaştırıcı ve resmi sözleşmeden açıklanmıştır. Rota kullanılabilirliği ve fiyatlar değişebilir; model kartına bakın.

Eksiksiz ortak istek parametreleri

Bu alanları üst düzeyde gönderin. En geniş uyumluluk için açık duration, resolution ve aspect_ratio kullanın, en fazla 5.000 karakterlik boş olmayan bir istem verin ve rotaya özgü seçenekleri atlayın.

Alan	Tür	Zorunlu / varsayılan	APIMaster davranışı
model	string	Zorunlu	Tam olarak wan3.0-video-prime
prompt	string	Her iki rotada da zorunlu	Boş olmamalı, görsel üretimi dahil. GMI 1–5.000 karakter doğrular; yerel bağdaştırıcı boş olmayan metin gerektirir. Resmi yerel sınır 20.000'dir; rotalar arasında bu daha yüksek sınıra güvenmekten kaçının
duration	integer	5	2–30 saniye; -1, kesirli değerler veya otomatik süre yok
seconds	string	İsteğe bağlı	Dize takma adı, örn. "5"; ikisi de verildiğinde duration ile uyuşmalıdır
resolution	string	720P	480P, 720P, 1080P; üst düzey küçük harf değerleri normalleştirilir. Bu APIMaster varsayılanı resmi yerel varsayılandan farklıdır
aspect_ratio	string	16:9	Yaygın değerler: adaptive, 16:9, 9:16, 1:1, 4:3, 3:4. 21:9 yalnızca yerel rotada
ratio	string	İsteğe bağlı	aspect_ratio takma adı; tek alan kullanın ve çelişkili değerler göndermeyin
size	string	İsteğe bağlı	1280x720 gibi boyut takma adı; rotaya özgü doğrulama uygulanır. resolution ve aspect_ratio tercih edin. GMI kısa kenarın çözünürlük kademesiyle eşleşmesini gerektirir; yerel yalnızca desteklenen boyut eşlemelerini kabul eder
input_reference	string	İsteğe bağlı	İlk kare görsel URL'si. Rotalar arası uyumluluk için herkese açık indirilebilir bir HTTP(S) URL'si kullanın; diğer ilk kare girdileriyle birleştirmeyin
prompt_extend	boolean	Yerel true; GMI atlandığında sağlayıcı varsayılanını bırakır	İstem yeniden yazımı. Yerel şu anda false ile güvenilir biçimde devre dışı bırakamaz; GMI açık bir boolean iletir
watermark	boolean	Resmi yerel varsayılan false; GMI atlandığında sağlayıcı varsayılanını bırakır	Filigran anahtarı
seed	integer	Atlandığında rastgele	Taşınabilir sabit aralık: 1–2147483647. Yerel ayrıca rastgele için -1 kabul eder; yerel 0 serileştirme sırasında atlanır. GMI 0–2147483647 kabul eder ve -1 reddeder. Sabit tohum aynı çıktıyı garanti etmez

Yerel boyut takma adları, olağan yatay/dikey durumlar için 832x480, 480x832, 1280x720, 720x1280, 1920x1080 ve 1080x1920 şeklindedir. Bazı kare boyut eşlemeleri 1:1 değerine indirgenir; diğer eşlenmiş boyutlar yine de en-boy oranı doğrulamasında başarısız olabilir. Rastgele boyutlar istemek için size kullanmayın.

Rotaya özgü parametre tabloları

GMI alanları

Bunlar, ortak tabloya ek olarak üst düzey alanlardır. GMI bağdaştırıcısı, metadata, images, image_urls, audio, generate_audio, video_urls ve reference_video dahil olmak üzere tanınmayan alanları reddeder.

Alan	Tür	Zorunlu / varsayılan	Davranış
negative_prompt	string	İsteğe bağlı	En fazla 500 karakter
first_frame	string	İsteğe bağlı	Herkese açık HTTP(S) görsel URL'si; input_reference alternatifi
last_frame	string	İsteğe bağlı	Herkese açık HTTP(S) son kare görsel URL'si; ayrıca bir ilk kare sağlayın
reference_image	string veya string[]	İsteğe bağlı	1–10 herkese açık HTTP(S) referans görsel URL'si; birden fazla görsel için dizi kullanın
audio_url	string	İsteğe bağlı	Herkese açık HTTP(S) referans ses URL'si; sağlayıcı medya doğrulamasına tabidir

Tek bir istekte kare kontrollerini veya referans görsellerini kullanın. Yerel metadata.input.media GMI'de bu alanlara çevrilmez.

Alibaba Cloud yerel alanları

Yerel yapılandırılmış girdiler metadata içine aittir. Resmi input veya parameters nesnelerini doğrudan üst düzeyde göndermek APIMaster sözleşmesi değildir. Zorunlu üst düzey prompt alanını her zaman koruyun.

Alan	Tür	Zorunlu / varsayılan	Davranış
generate_audio	boolean	Resmi yerel varsayılan true	Çıktının ses parçası içerip içermeyeceği; false korunur
audio	boolean	İsteğe bağlı	generate_audio takma adı; yalnızca birini sağlayın
images	string[]	İsteğe bağlı	reference_image medya girişlerine dönüştürülür; bunlar sıralı ilk/son kareler değildir. input_reference ile birleştirmeyin
metadata	object	İsteğe bağlı	Yerel input ve parameters alanlarını sarar; model değiştiremez
metadata.input	object	İsteğe bağlı	Yerel girdi kapsayıcısı
metadata.input.prompt	string	İsteğe bağlı	Yerel istem geçersiz kılma; yalnızca üst düzey istemi tercih edin
metadata.input.media	object[]	İsteğe bağlı	Yerel medya koleksiyonu; her öğede type ve url bulunur
metadata.input.media[].type	string	Öğe başına zorunlu	first_frame, last_frame, reference_image, reference_audio, file, link; reference_video şu anda reddedilir
metadata.input.media[].url	string	Öğe başına zorunlu	Medya konumu; herkese açık HTTP(S) URL'leri önerilir. Resmi OSS geçici URL'leri ayrıca geçerli bir üst kaynak yükleme bağlamı gerektirir; APIMaster bu yükleme bağlamını sağlamaz
metadata.parameters	object	İsteğe bağlı	Yerel parametre kapsayıcısı; null olmamalıdır
metadata.parameters.resolution	string	720P	Büyük harf 480P, 720P, 1080P
metadata.parameters.ratio	string	16:9	adaptive ve 21:9 dahil yerel en-boy oranları
metadata.parameters.duration	integer	5	2–30; -1 yok
metadata.parameters.audio	boolean	Resmi yerel varsayılan true	Çıktı ses anahtarı
metadata.parameters.prompt_extend	boolean	true	file / link için true kalmalıdır; açık false yukarıdaki serileştirme sınırlamasına sahiptir
metadata.parameters.watermark	boolean	Resmi yerel varsayılan false	Filigran anahtarı
metadata.parameters.seed	integer	Rastgele	-1 veya 0–2147483647; 0 yukarıdaki serileştirme sınırlamasına sahiptir

Üst düzey yerel seçenekler, karşılık gelen metadata parametrelerini geçersiz kılar. Üst düzey input_reference, yerel medya dizisinin yerini alır; input_reference yokken images referans görsel girişleri ekler. Kazara geçersiz kılmalardan kaçınmak için tek bir girdi stili ve tek bir parametre stili kullanın. Yerel input içinde eski img_url, first_frame_url, last_frame_url veya audio_url alanlarını kullanmayın; bağdaştırıcı Wan 3.0 için bu eski medya alanlarını reddeder.

Medya kısıtlamaları

Aşağıdaki resmi yerel medya kuralları, sağlayıcı tarafındaki doğrulamayı da açıklar; bir bağdaştırıcının URL'yi kabul etmesi medyanın geçerli olduğunu kanıtlamaz.

Medya	Sınırlar / entegrasyon notları
İlk / son kareler	Her biri en fazla bir tane; son kare bir ilk kare gerektirir. Kare kontrollerini reference_image ile karıştırmayın
Referans görseller	En fazla 10; JPEG/JPG, saydamlık içermeyen PNG, BMP veya WEBP; her kenar 240–8.000 piksel, en-boy oranı en fazla 8:1, görsel başına en fazla 20 MB
Referans ses	Yerel: en fazla 5, WAV/MP3, her biri 1–15 saniye, toplamda en fazla 15 saniye, dosya başına en fazla 15 MB. GMI bir audio_url sunar
Dosya / web sayfası	Yalnızca yerel: en fazla bir dosya veya bir herkese açık okunabilir sayfa; file ve link birleştirmeyin. Resmi dosya biçimleri: DOCX, DOC, XLSX, XLS, PPTX, PPT, PDF, TXT, KEY, PAGES, NUMBERS, MD; en fazla 100 MB, uygulanabilir sayfalı biçimler için 50 sayfa sınırı. prompt_extend: true değerini koruyun
Referans video	Resmi olarak mevcut, ancak şu anda APIMaster yerel faturalandırma doğrulaması tarafından engelleniyor; GMI'de sunulmaz. Resmi API'deki video düzenleme veya uzatma örneklerini burada kullanmayın

Resmi yerel birleşik medya üst sınırı 20 öğedir; bireysel ve kombinasyon sınırları yine de geçerlidir. Görsel Base64 veri URL'leri resmi yerel girdi biçiminin bir parçasıdır, ancak GMI URL doğrulaması tarafından kabul edilmez. Rotalar arasında indirilebilir HTTP(S) URL'lerini tercih edin.

Örnekler

Metinden videoya, ortak alanlar

curl "https://apimaster.ai/v1/videos" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"wan3.0-video-prime","prompt":"A paper boat drifting across a quiet pond at sunrise, gentle camera movement.","duration":5,"resolution":"720P","aspect_ratio":"16:9"}'

İlk kare, ortak alanlar

{"model":"wan3.0-video-prime","prompt":"The boat moves slowly forward, with soft ripples.","input_reference":"https://example.com/boat.png","duration":5,"resolution":"720P","aspect_ratio":"16:9"}

GMI ilk / son kareler

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","first_frame":"https://example.com/start.png","last_frame":"https://example.com/end.png","duration":5,"resolution":"720P","prompt_extend":false,"seed":0}

Yerel ilk / son kareler ve sessiz çıktı

{"model":"wan3.0-video-prime","prompt":"Move smoothly from the first frame to the last frame.","duration":5,"resolution":"720P","generate_audio":false,"metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}

Yerel referans görsel ve ses

{"model":"wan3.0-video-prime","prompt":"Animate the character in image 1, with the mood of audio 1.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"reference_image","url":"https://example.com/character.png"},{"type":"reference_audio","url":"https://example.com/music.mp3"}]}}}

Örnek medya URL'lerini gerçek herkese açık dosyalarla değiştirin. Rotaya özgü örnekler eşleşen rotayı gerektirir ve üst kaynak kombinasyon kontrollerine tabi olmaya devam eder.

Yanıt, yoklama ve indirme

Oluşturma, bir APIMaster görev kimliği döndürür, örneğin:

{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video-prime","status":"queued"}

Alan	Anlamı
id / task_id	APIMaster görev tanımlayıcısı, üst kaynak görev tanımlayıcısı değil
status	queued, in_progress, completed, failed
progress	Bildirilen ilerleme; tamamlanma garantisi değil
error.code / error.message	Uygulanabildiğinde hata ayrıntıları
metadata.url	Tamamlanmada döndürüldüğünde kimlik doğrulamalı içerik adresi

Son duruma ulaşana kadar aynı API anahtarıyla her 10–20 saniyede bir yoklayın; oluşturma başarısı yalnızca kabul anlamına gelir. Üretim birkaç dakika sürebilir. Ücretli görevleri tekrar tekrar oluşturmak yerine kabul edilen bir görevi yoklayın.

curl "https://apimaster.ai/v1/videos/task_example" -H "Authorization: Bearer YOUR_API_KEY"
curl -L "https://apimaster.ai/v1/videos/task_example/content" \
  -H "Authorization: Bearer YOUR_API_KEY" -o wan-prime.mp4

Tamamlanan videoyu hemen indirin ve kaydedin; üst kaynak sonuç URL'leri süresi dolabilir. Tekrarlanan yoklama ek bir üretim ücreti oluşturmaz.

Faturalandırma ve yaygın hatalar

Faturalandırma, istenen çözünürlükte saniye başınadır ve rota/hesap fiyatlandırması model kartında gösterilir. Gönderim, tahmini ücreti rezerve eder. Yerel tamamlanma, döndürülen faturalandırılabilir süreyi ve dondurulmuş gönderim fiyatını kullanır; GMI rezerve edilen süre sözleşmesini izler. Başarısız görevler üretim rezervasyonlarını serbest bırakır/iade eder. Sesin kapalı olması daha ucuz bir kademe anlamına gelmez. Nihai tutar için kullanım günlüğünü kullanın.

Hata / belirti	Eylem
duration must be an integer from 2 to 30	Açık bir tam sayı kullanın; -1 entegre değildir
unsupported Wan request field ...	GMI tarafından desteklenmeyen bir alanı kaldırın veya eşleşen yerel rotaya erişimi doğrulayın
unsupported aspect ratio	Yaygın bir oran kullanın; 21:9 yerel yönlendirme gerektirir
reference video requires an input-duration quote	Referans videoyu kaldırın; bu yetenek şu anda engellenmiştir
prompt is required / medya alma hatası	Üst düzey metin ekleyin; herkese açık indirilebilir, geçerli medya kullanın
prompt_extend: false veya seed: 0 yerelde etkisiz	Mevcut serileştirme sınırlaması; pozitif bir tohum kullanın ve yeniden yazımı devre dışı bırakmaya bağlı kalmayın

Kaynaklar: resmi model bilgileri, resmi yerel API referansı ve resmi kullanım kılavuzu. Resmi yetenek, aynı alanın her APIMaster rotasında sunulduğu anlamına gelmez.