APIMaster.ai

Vidu Image Q2 · API başvurusu

Vidu Image Q2 ile metinden veya referans görsellerden görsel oluşturun, görev durumunu kontrol edin ve sonuçları indirin.

POST /v1/wand/vidu-image/generation ile bir görev oluşturun ve GET /v1/wand/vidu-image/tasks/{task_id} ile sorgulayın. APIMaster API anahtarını Authorization: Bearer başlığına her iki istekle birlikte gönderin. POST isteğinin gövdesi JSON biçimindedir.

Alan Tür Açıklama
model string Zorunlu. vidu-image-q2 kullanın.
prompt string Zorunlu. En çok 2,000 karakter. Yalnızca metinden görsel oluşturmak için referans görselleri atlayın (text-to-image).
images string[] İsteğe bağlıdır. PNG, JPEG/JPG veya WebP biçiminde en fazla yedi herkese açık URL ya da veri URI'si girilebilir. Her görsel en az 128 × 128 piksel olmalıdır. En boy oranı 1:4 ile 4:1 arasında, dosya boyutu en fazla 50 MB olmalıdır. İstek gövdesinin tamamı en fazla 20 MB olabilir.
aspect_ratio string 16:9 varsayılan olarak. Seçenekler 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 ve auto'dir. auto ayarı ilk referans görüntüsünü takip eder.
resolution string 1080p varsayılan olarak. 2K ve 4K'yi de destekler. Değerler büyük ve küçük harfe duyarlıdır.
seed integer Rastgele bir tohum için alanı atlayın veya 0 girin.
curl -X POST "https://apimaster.ai/v1/wand/vidu-image/generation" \
  -H "Authorization: Bearer $APIMASTER_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"vidu-image-q2","prompt":"A blue circle on a white background","resolution":"1080p"}'

Döndürülen task_id ve aynı hesapla her 3–5 saniyede bir durumu sorgulayın. Olası durumlar created, queueing, processing, success ve failed'dir. Başarı üzerine, creations[].url altındaki dosyaları 12 saatleri içinde indirin. request_id'yi geçersiz resimler, içerik incelemesi, yetersiz kredi, oran sınırları veya eksik görevler gibi hataları izlemek için kullanın.

Durum sorgulaması yeni bir oluşturma işlemi başlatmaz ve yeniden ücretlendirme yapmaz. callback_url desteklenmiyor. Kayıp bir gönderimi kurtarmak için, 8–128 görünür ASCII karakterlerinden kararlı bir Idempotency-Key gönderin ve İstek kurtarma kılavuzu'yi takip edin. Aynı anahtar ve aynı parametreler HTTP 202 ile kurtarma makbuzu döndürür. Aynı anahtarla farklı parametreler HTTP 409 döndürür.

tokenhub_usage.total_tokens, çözünürlüğe ve kaç referans kullanıldığına bağlı olarak faturalanabilir kullanımı bildirir. Bakınız: Vidu Image Q2 model kartı akım için APIMaster Fiyat.