APIMaster.ai

Vidu Video Q4 Preview · API başvurusu

Tek bir görüntüden veya referanslardan bir video oluşturun, ardından APIMaster görevini yoklayın.

POST /v1/wand/vidu/image-to-video'yi tek bir başlangıç görüntüsü için veya referans güdümlü nesil için POST /v1/wand/vidu/reference-to-video'yi kullanın. GET /v1/wand/vidu/tasks/{task_id} ile anket. Gönderme için JSON ve her istek için Bearer kimlik doğrulamasını kullanın. Bu model için yalnızca metin oluşturma ve ayrı bir başlangıç/son-frame uç noktası kullanılamaz.

Alan Tür Açıklama
model string Zorunlu. vidu-video-q4-preview kullanın.
images string[] Image-to-video tam olarak tek bir görüntü gerektirir. Reference-to-video, 15 görüntülerine veya subjects'ye kadar kabul eder. Halka açık kullan URLs veya veri URI'leri PNG, JPEG/JPG, veya WebP. En boy oranı 1:4'den 4:1'ye olmalıdır. Her URL görüntüsü 50 MB'ye kadar olabilir. Base64 görüntüleri kodlamadan önce 15 MB ve toplamda kodlanmış 20 MB ile sınırlıdır.
subjects object[] reference-to-video için images'ye bir alternatif olarak. Her öğenin name'sini ve bir ila üç images'yi ayarlayın. Hemen @name ile bir konuya bakın.
prompt string reference-to-video için gereklidir. Doğrudan resim referansları için 2,000 karakterlerine veya konular için 5,000 ve image-to-video'ye kadar. Image-to-video açıkken is_rec bu alanı görmezden gelir.
auto_subjects boolean reference-to-video için konu kitaplığı seçeneği. Varsayılan değer false.
audio boolean reference-to-video için image-to-video ve false için öntanımlı true. Sesli referans video subjects ve açık bir true değeri gerektirir.
audio_type string Ses etkinleştirildiğinde, all (varsayılan), speech_only veya sound_effect_only kullanın.
is_rec boolean image-to-video için otomatik hızlı öneri. Bunun sağlanması görev kullanımını artırır.
duration integer 3'den 16 saniyesine kadar, 5 varsayılan olarak.
resolution string 540p, 720p (varsayılan), 1080p, 2K veya 4K.
aspect_ratio string Reference-to-video sadece. 16:9 (varsayılan), 9:16, 3:4, 4:3 veya 1:1 kullanın. Image-to-video giriş görüntüsünü takip eder.
seed integer Rastgele bir tohum için alanı atlayın veya 0 girin.
payload string İsteğe bağlı uygulama verileri, 1,048,576 karakterlerine kadar.
watermark boolean Varsayılan değer false.
wm_url string İsteğe bağlı özel filigran URL. Varsayılan filigran sol üstte görünür. API, wm_position'yi kabul etmez.
curl -X POST "https://apimaster.ai/v1/wand/vidu/image-to-video" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-video-q4-preview","images":["https://example.com/reference.jpg"],"prompt":"Slow camera pan","duration":5,"resolution":"720p"}'

task_id ve aynı hesapla her 5–10 saniyede bir durumu sorgulayın. Devletler created, queueing, processing, success ve failed'dir. Başarı üzerine, creations[].url video ve creations[].cover_url onun kapağıdır. 12 saatleri içinde geçici bağlantıları indirin. Bir arızayı bildirirken request_id'yi saklayın.

Bir kullan Idempotency-Key hakkında 8–128 görünür ASCII Bir gönderimi kurtarmak için karakterler. Aynı anahtar ve aynı parametreler HTTP 202 ile kurtarma makbuzu döndürür. Aynı anahtarla farklı parametreler HTTP 409 döndürür. Bakınız İstek kurtarma kılavuzu. Sorgu zaman aşımları yeni bir video oluşturmadan tekrar denenebilir.

Ağ geçidi nesile bir kez yerleşir. tokenhub_usage.total_tokens faturalanabilir kullanım rapor eder. Bakınız: Vidu Video Q4 Preview model kartı akım için APIMaster Fiyat.