Vidu Image Q2 · Referensi API
Buat gambar dengan Vidu Image Q2 dari teks atau gambar referensi. Periksa status tugas dan unduh hasilnya.
Buat tugas dengan POST /v1/wand/vidu-image/generation dan query dengan GET /v1/wand/vidu-image/tasks/{task_id}. Kirim kunci APIMaster API dalam header Authorization: Bearer dengan kedua permintaan. Isi permintaan POST menggunakan format JSON.
| Kolom | Tipe | Deskripsi |
|---|---|---|
model |
string | Wajib. Gunakan vidu-image-q2. |
prompt |
string | Wajib. Maksimal 2,000 karakter. Hilangkan gambar referensi untuk membuat gambar hanya dari teks (text-to-image). |
images |
string[] | Opsional. Hingga tujuh URL publik atau URI data dalam format PNG, JPEG/JPG, atau WebP. Setiap gambar harus berukuran minimal 128 × 128 piksel, dengan rasio aspek antara 1:4 dan 4:1 serta ukuran maksimal 50 MB. Batas ukuran isi permintaan adalah 20 MB. |
aspect_ratio |
string | 16:9 Secara default. Opsi adalah 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2, dan auto. Pengaturan auto mengikuti gambar referensi pertama. |
resolution |
string | 1080p Secara default. Juga mendukung 2K dan 4K. Huruf besar dan kecil dibedakan. |
seed |
integer | Hilangkan kolom atau gunakan 0 untuk seed acak. |
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"}'
Gunakan task_id dari respons dan akun yang sama untuk memeriksa status setiap 3–5 detik. Status yang mungkin created, queueing, processing, success, dan failed. Saat sukses, download file dibawah creations[].url dalam waktu 12 jam. Gunakan request_id untuk melacak kegagalan seperti gambar yang tidak valid, ulasan konten, tidak cukup kredit, batas laju, atau tugas yang hilang.
Memeriksa status tidak memulai pembuatan ulang dan tidak menimbulkan biaya tambahan. callback_url tidak didukung. Untuk memulihkan penyerahan yang hilang, mengirim sebuah stabil Idempotency-Key dari 8–128 terlihat ASCII karakter dan mengikuti Panduan pemulihan permintaan. Kunci dan parameter yang sama mengembalikan tanda terima pemulihan dengan HTTP 202. Parameter berbeda dengan kunci yang sama mengembalikan HTTP 409.
tokenhub_usage.total_tokens laporan penggunaan tagihan, yang tergantung pada resolusi dan berapa banyak referensi yang digunakan. Lihat Vidu Image Q2 model card saat ini untuk harga APIMaster.
