Ce guide n'est disponible qu'en anglais pour le moment. →
Paramètres de requête
| Paramètre | Requis | Description |
|---|---|---|
bgm | Non | Add a background music bed that fits the scene. Par défaut: true |
duration_seconds | Non | La durée du clip. Facturée à la seconde. ≥ 1 · ≤ 16 · Par défaut: 5 |
generate_audio | Non | Ajoute un son assorti à l’image : voix, ambiance et effets. Par défaut: true |
image_url | Oui | L’image de départ. |
movement_amplitude | Non | L’ampleur des mouvements du sujet et de la caméra. auto · small · medium · large · Par défaut: auto |
prompt | Oui | Describe what happens after the opening frame: the action, the camera, and the mood. |
resolution | Non | Taille de sortie. Plus c’est grand, plus c’est net et plus c’est cher. 540p · Par défaut: 540p |
seed | Non | Le même nombre donne un résultat reproductible. ≥ 0 · ≤ 2147483647 |
Tarifs
Les prix sont en crédits, les mêmes que ceux que vous utilisez sur le site (1 crédit = 0,01 $). Le montant est réservé à l'acceptation de la tâche, puis réglé au coût réel à la fin ; les tâches en échec sont remboursées.
| Option | Crédits par seconde | ≈ USD |
|---|---|---|
| Standard | 8,1 | 0,081 $US |
Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 41 crédits pour un clip de 5 secondes (0,41 $US).
Pour obtenir un montant exact avant de lancer, envoyez le même corps à POST /jobs/quote.
Démarrage rapide de l'API
Appeler l’API Vidu Q3 Pro en trois étapes
- Créer une clé API. Connectez-vous à PopNow et créez une clé dans la console API. Les clés commencent par sk-popnow- et utilisent les mêmes crédits que le site.
- Envoyer la requête. Envoyez POST /jobs/createTask avec model vidu/q3-pro/image-to-video et un objet input conforme au tableau des paramètres. La réponse renvoie aussitôt un ID de tâche.
- Récupérer le résultat. Interrogez GET /jobs/recordInfo avec l’ID de tâche, ou passez une callBackUrl et nous y envoyons le résultat. Téléchargez les liens de sortie quand la tâche réussit.
# 1. Create the task. Keep the Idempotency-Key if you retry after a network error.
export IDEMPOTENCY_KEY="$(uuidgen)"
curl -X POST https://api.popnow.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $POPNOW_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-d '{
"model": "vidu/q3-pro/image-to-video",
"input": {
"prompt": "A slow aerial shot drifting over a misty pine forest at sunrise",
"image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
"movement_amplitude": "auto",
"duration_seconds": 5,
"resolution": "540p"
}
}'
# 2. Copy data.taskId from the response, then poll until state is succeeded, failed, canceled or expired.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $POPNOW_API_KEY"Remplacez le prompt et les liens par les vôtres. L'onglet API contient la référence pour la réponse, le polling et le callback.
Questions sur l’API Vidu Q3 Pro
Combien coûte l’API Vidu Q3 Pro ?
Vidu Q3 Pro coûte 41 crédits (0,41 $US) pour un clip de 5 secondes. Les crédits sont les mêmes que sur le site (1 crédit = 0,01 $), les nouveaux comptes reçoivent 30 crédits offerts et les tâches échouées sont remboursées.
Quel est le nom de modèle de Vidu Q3 Pro dans l’API ?
Indiquez vidu/q3-pro/image-to-video pour Image vers vidéo dans le champ model de POST /jobs/createTask.
Que fait Vidu Q3 Pro ?
Il met en mouvement une image d’ouverture que vous fournissez. L’image décide du sujet, du rendu et de la forme ; le prompt décrit le mouvement, la caméra et le son. Les clips durent de 1 à 16 secondes entières en 540p.
Comment décider de la forme du clip ?
Par l’image fixe. Une image verticale revient en clip vertical et une image carrée en clip carré : la forme du livrable se décide donc à l’étape image.
Quelle différence avec Vidu Q3 Turbo ?
Les deux prennent les mêmes champs en image-to-video. La différence tient à la résolution proposée : Pro tourne en 540p, Turbo propose 540p et 720p.
Quelles sont les limites de l’API Vidu Q3 Pro ?
Durée du clip: 1–16 s; Résolutions: 540p. Les requêtes hors de ces limites sont refusées avant tout débit.
Puis-je essayer Vidu Q3 Pro sans écrire de code ?
Oui. Le Playground lance Vidu Q3 Pro avec vos crédits PopNow, sans clé API, et affiche le code correspondant à chaque génération.
Tous les modèles Vidu
- API Vidu Q4 PreviewClips jusqu’en 4K avec son et dialogues parlésÀ partir de 34 crédits pour un clip de 5 secondes
- API Vidu Q3 TurboAnimation d’image rapide avec son, jusqu’à 16 secondesÀ partir de 32 crédits pour un clip de 5 secondes
- API Vidu Q3Anime une image jusqu’à 16 secondes en 1080pÀ partir de 53 crédits pour un clip de 5 secondes
- API Vidu Q3 ProAnime une image avec le son activé par défaut, jusqu’à 16 secondesÀ partir de 41 crédits pour un clip de 5 secondes

