APIMaster.ai

Vidu Image Q2 · Référence de l’API

Générez des images avec Vidu Image Q2 à partir de texte ou d’images de référence. Consultez les tâches et téléchargez les résultats.

Créez une tâche avec POST /v1/wand/vidu-image/generation et interrogez-la avec GET /v1/wand/vidu-image/tasks/{task_id}. Envoyez une clé API APIMaster dans l'en-tête Authorization: Bearer avec les deux requêtes. Le corps de la requête POST est au format JSON.

Champ Type Description
model string Obligatoire. Utilisez vidu-image-q2.
prompt string Obligatoire. Jusqu’à 2,000 caractères. Pour générer une image à partir de texte seul, omettez les images de référence (text-to-image).
images string[] Facultatif. Jusqu’à sept URL publiques ou URI de données en PNG, JPEG/JPG ou WebP. Chaque image doit mesurer au moins 128 × 128 pixels, avec un rapport largeur/hauteur compris entre 1:4 et 4:1 et une taille maximale de 50 MB. Le corps de la requête est limité à 20 MB.
aspect_ratio string 16:9 par défaut Les options sont 16:9, 9:16, 1:1, 3:4, 4:3, 21:9, 2:3, 3:2 et auto. Le paramètre auto suit la première image de référence.
resolution string 1080p par défaut Prend également en charge 2K et 4K. Les valeurs sont sensibles à la casse.
seed integer Omettez le champ ou utilisez 0 pour une graine aléatoire.
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"}'

Interrogez le statut toutes les 3–5 secondes avec le task_id renvoyé et le même compte. Les états possibles sont created, queueing, processing, success et failed. En cas de succès, téléchargez les fichiers sous creations[].url dans les heures 12. Utilisez request_id pour retracer les défaillances telles que les images non valides, l'examen du contenu, le crédit insuffisant, les limites de taux ou les tâches manquantes.

Consulter le statut conserve la tâche et les frais d’origine. callback_url n'est pas pris en charge. Pour récupérer une soumission perdue, envoyez un Idempotency-Key stable de caractères 8–128 visibles ASCII et suivez le guide de récupération de la soumission Guide de récupération des requêtes. La même clé et les mêmes paramètres renvoient un reçu de récupération avec le statut HTTP 202. La même clé avec des paramètres différents renvoie le statut HTTP 409.

tokenhub_usage.total_tokens indique l'utilisation facturable, qui dépend de la résolution et du nombre de références utilisées. Voir le Vidu Image Q2 modèle card pour le prix actuel APIMaster.