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.
