Wan 3.0 Video API
wan3.0-video için APIMaster üzerinde parametreler, medya kombinasyonları, eşzamansız görevler, indirmeler ve saniye başına faturalandırma.
Wan 3.0 Video API
wan3.0-video standart Wan 3 modelidir; wan3.0-video-prime modelinden ayrı bir modeldir. Metin, görseller, video, ses, belgeler ve herkese açık web sayfalarını destekler. Her başarılı görev, en fazla 30 saniye uzunluğunda bir MP4/H.264 videosu üretir. Entegrasyon inceleme tarihi: 2026-11-17.
Her istek toplam en fazla 20 medya öğesi kabul eder. Oluşturulan video 30 fps kullanır.
Uç Noktalar ve Kimlik Doğrulama
| İşlem | Uç Nokta |
|---|---|
| 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 |
Authorization: Bearer YOUR_API_KEY · Content-Type: application/json
Tüm istek parametreleri
Her istekte tek bir medya biçimi kullanın. Karma referans medyası veya belgeler için metadata.input.media kullanın.
| Parametre | Tür | Zorunlu / varsayılan | Anlam ve geçerli değerler |
|---|---|---|---|
model |
string | Zorunlu | Tam olarak wan3.0-video; Prime ile değiştirmeyin |
prompt |
string | Zorunlu | Sonucu Çince veya İngilizce olarak tanımlayın; resmi sınır 20.000 karakter, daha uzun yerel metin kısaltılır. Medya sırasına göre Image 1, Video 1, Audio 1 olarak başvurun; her medya türünün kendi numaralandırması vardır |
duration |
integer | 5 |
2–30 çıktı saniyesi; -1 modelin süreyi seçmesine izin verir. Referans video ile girdi ve çıktı süresi toplamı 30 saniyeyi aşamaz |
seconds |
string | İsteğe bağlı | Süre takma adı, örn. "5" veya "-1"; her ikisi de sağlandığında duration ile eşleşmelidir |
resolution |
string | 1080P |
480P, 720P, 1080P; küçük harfli üst düzey değerler normalleştirilir |
aspect_ratio |
string | adaptive |
adaptive, 21:9, 16:9, 4:3, 1:1, 3:4, 9:16 |
ratio |
string | İsteğe bağlı | aspect_ratio için takma ad; video uzatma için adaptive önerilir |
size |
string | İsteğe bağlı | Uyumluluk takma adı: çözünürlük kademesi veya 1280x720 gibi desteklenen bir piksel eşlemesi; açık çözünürlük ve oran tercih edin, rastgele piksel boyutları kullanmayın |
generate_audio |
boolean | Üst akışta true |
Çıktının ses parçası olup olmayacağı. Açık false korunur. Ses, saniye başına ücreti değiştirmez |
audio |
boolean | İsteğe bağlı | generate_audio için takma ad; tek bir ses anahtarı kullanın |
prompt_extend |
boolean | true |
Akıllı prompt yeniden yazma; açık false korunur. Belge/sayfa girdisi için true olmalıdır |
watermark |
boolean | Üst akışta false |
Çıktıya filigran ekleyin; açık false korunur |
seed |
integer | Rastgele | -1 veya 0–2147483647. Atlama veya -1 rastgele tohum ister; 0 iletilir. Tekrarlanan tohumlar aynı çıktıyı garanti etmez |
input_reference |
string | İsteğe bağlı | İlk kare görsel URL'si; yerel medya dizisinin yerini alır. Girdi stillerini karıştırmayın |
images |
string[] | İsteğe bağlı | input_reference yoksa reference_image öğeleri olarak eklenen kolaylık dizisi |
metadata |
object | İsteğe bağlı | Aşağıdaki yerel nesneler için kapsayıcı; seçili modeli değiştiremez |
metadata.input |
object | İsteğe bağlı | Yerel input nesnesi |
metadata.input.prompt |
string | İsteğe bağlı | Yerel prompt geçersiz kılma; zorunlu üst düzey prompt'u koruyun |
metadata.input.media |
object[] | İsteğe bağlı | Sıralı medya dizisi. Her öğe type ve url gerektirir; aşağıdaki sınırlara bakın |
metadata.input.media[].type |
string | Öğe başına zorunlu | first_frame, last_frame, reference_image, reference_video, reference_audio, file, link |
metadata.input.media[].url |
string | Öğe başına zorunlu | Genel HTTP(S) medya URL'si; görsel türleri ayrıca data:{MIME_type};base64,... dizesini kabul eder. Görsel olmayan medya genel bir URL gerektirir |
metadata.parameters |
object | İsteğe bağlı | Yerel parametre nesnesi; null olamaz |
metadata.parameters.resolution |
string | 1080P |
Büyük harfli 480P, 720P, 1080P |
metadata.parameters.ratio |
string | adaptive |
Yukarıda listelenen aynı en-boy oranı değerleri |
metadata.parameters.duration |
integer | 5 |
2–30 veya -1; aynı birleşik süre kısıtlaması |
metadata.parameters.audio |
boolean | Üst akışta true |
Aynı çıktı ses anahtarı |
metadata.parameters.prompt_extend |
boolean | true |
Aynı prompt yeniden yazma anahtarı; file/link true gerektirir |
metadata.parameters.watermark |
boolean | Üst akışta false |
Aynı filigran anahtarı |
metadata.parameters.seed |
integer | Rastgele | Açık 0 dahil aynı tohum aralığı |
Yerel negative_prompt, img_url, first_frame_url, last_frame_url ve audio_url alanları Wan 3 medya kontrolleri değildir. Bunun yerine belgelenen medya dizisini kullanın.
Medya sınırları ve geçerli kombinasyonlar
| Medya türü | Sayı ve kısıtlamalar |
|---|---|
first_frame, last_frame |
En fazla birer adet. Son kare, ilk kareyi gerektirir. Kare kontrolleri herhangi bir referans, dosya veya bağlantı türüyle birleştirilemez |
reference_image |
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, her dosya en fazla 20 MB |
reference_video |
En fazla 5 MP4/MOV klip; her biri 1–15 saniye, birleşik girdi en fazla 15 saniye; en az 16 fps; her kenar 240–4.096 piksel, en-boy oranı en fazla 8:1, her dosya en fazla 100 MB |
reference_audio |
En fazla 5 WAV/MP3 klip; her biri 1–15 saniye, birleşik en fazla 15 saniye; her dosya en fazla 15 MB |
file |
En fazla bir DOCX/DOC/XLSX/XLS/PPTX/PPT/PDF/TXT/KEY/PAGES/NUMBERS/MD dosyası; en fazla 100 MB. PDF, DOCX, DOC, PPTX, PPT ve KEY/PAGES sayfalı belgelerinde 50 sayfa sınırı vardır |
link |
En fazla bir, giriş gerektirmeyen herkese açık sayfa; file ile birleştirmeyin |
Referans görseller, video ve ses birleştirilebilir. Bir dosya veya bağlantı, referans medyaya eşlik edebilir. İlk/son kare modu yalnızca kare kontrollerini kabul eder; sesle yönlendirilen üretim için referans görsel artı referans ses modunu kullanın. Medya ayrıştırma ve içerik denetimi, üst akış kontrollerine tabi olmaya devam eder.
Metinden videoya, medya içermeyen bir istem kullanır. İlk kare animasyonu first_frame kullanır; geçişler first_frame ve last_frame kullanır. Referans üretimi, referans türlerini kullanır. Düzenleme veya uzatma için reference_video sağlayın ve istemde düzenlemeyi veya uzatmayı açıklayın; uzatma için adaptive kullanın.
Örnekler
Metinden videoya
curl "https://apimaster.ai/v1/videos" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model":"wan3.0-video","prompt":"A paper boat drifting on a quiet pond, static camera.","duration":2,"resolution":"480P","aspect_ratio":"16:9","generate_audio":false,"prompt_extend":false,"watermark":false,"seed":0}'
İlk ve son kareler
{"model":"wan3.0-video","prompt":"Move smoothly from the first frame to the last.","duration":5,"resolution":"720P","metadata":{"input":{"media":[{"type":"first_frame","url":"https://example.com/start.png"},{"type":"last_frame","url":"https://example.com/end.png"}]}}}
Referans görsel ve ses
{"model":"wan3.0-video","prompt":"Animate Image 1 to the rhythm 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"}]}}}
Video düzenleme / uzatma ve akıllı süre
{"model":"wan3.0-video","prompt":"Extend Video 1 forward as the camera follows the paper boat.","duration":-1,"resolution":"480P","aspect_ratio":"adaptive","metadata":{"input":{"media":[{"type":"reference_video","url":"https://example.com/input.mp4"}]}}}
Belge / web sayfası
{"model":"wan3.0-video","prompt":"Create a product introduction based on this document.","duration":10,"resolution":"720P","prompt_extend":true,"metadata":{"input":{"media":[{"type":"file","url":"https://example.com/product.pdf"}]}}}
Tüm örnek URL'leri gerçek genel medyayla değiştirin. Web girdisi için, dosya öğesini {"type":"link","url":"https://example.com/product"} ile değiştirin. İlk kare örneği, son kare öğesi olmadan da çalışır.
Yanıtlar, yoklama, indirmeler ve günlükler
Oluşturma, üst kaynak kimliğini değil, bir APIMaster görev kimliğini döndürür:
{"id":"task_example","task_id":"task_example","object":"video","model":"wan3.0-video","status":"queued"}
| Yanıt alanı | Anlamı |
|---|---|
id / task_id |
Sorgulama ve indirme tarafından kullanılan platform görev tanımlayıcısı |
status |
queued, in_progress, completed, failed |
progress |
İlerleme göstergesi; terminal durumunu bekleyin |
error.code, error.message |
Uygulanabilir olduğunda hata |
metadata.url |
Tamamlanma sırasında döndürüldüğünde konum |
Aynı API anahtarını kullanarak yaklaşık her 15 saniyede bir yoklayın. İlerlemeyi kontrol etmek için başka bir görev oluşturmayın. Yerel sağlayıcının görev kimlikleri ve çıktı URL'leri 24 saat sonra sona erer; başarılı sonuçları hemen indirin ve saklayın. APIMaster'ın kimliği doğrulanmış içerik uç noktası, geçici üst kaynak URL'lerini depolamaya tercih edilir.
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 wan3.mp4
Kullanım günlüğü, görevi ve başarılı video sonucunu içerir. Tamamlandıktan sonra nihai ücreti kontrol edin; kabul, oluşturmanın kanıtı değildir. Tekrarlanan yoklama başka bir oluşturma ücreti oluşturmaz.
Faturalandırma
Saniyelik ücretleri burada görebilirsiniz model kartı.
APIMaster tüm girdi videolarının süresiyle çıktı videosunun süresini toplar, toplamı bir kez yukarı yuvarlayarak tam saniyeye çıkarır ve seçilen çıktı çözünürlüğünün saniyelik fiyatıyla çarpar. 2,3 saniye girdi ve 5 saniye çıktı 8 saniye olarak ücretlendirilir. Girdi videosu yoksa yalnızca çıktı süresi ücretlendirilir. Teklif almak veya girdi süresini belirtmek gerekmez. Üretim başarısız olursa ayrılan tutar iade edilir. Son tutar kullanım kaydında görünür.
Hatalar ve düzeltmeler
| Belirti | Düzeltme |
|---|---|
| Geçersiz süre/çözünürlük/oran | Yukarıdaki enum ve aralıkları kullanın; akıllı süre tam olarak -1 değeridir |
| Kare/referans çakışması, ilk kare olmadan son kare | Kombinasyon kurallarını izleyin |
| Dosya/bağlantı ve devre dışı bırakılmış yeniden yazma | prompt_extend:true olarak ayarlayın |
| Medya getirme/biçim/süre hatası | Boyut, biçim ve süre kısıtlarının tümünü karşılayan herkese açık dosyalar kullanın |
| Eksik prompt | APIMaster API için boş olmayan üst düzey prompt değerini koruyun |
| Görev başarısız oldu veya denetlendi | error alanını inceleyin, ardından isteği düzeltin; kabul edilmesini başarı olarak saymayın |
