APIMaster.ai

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