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.
