API Vidu Q3: vidéo 1080p avec son

Name: Vidu Q3 API
SKU: vidu/q3/image-to-video
Price: 0.53 USD
Availability: InStock

À propos de Vidu Q3

Vidu Q3 publie un seul endpoint vidéo, image-to-video : vous fournissez l’image de départ et décrivez ce qui se passe ensuite. Les clips durent de 1 à 16 secondes en 540p, 720p ou 1080p, et l’audio est généré avec l’image tant que vous ne le coupez pas.

Appelez-le avec le nom de modèle vidu/q3/image-to-video sur POST /jobs/createTask, à partir de 53 crédits pour un clip de 5 secondes (0,53 $US). Les nouveaux comptes reçoivent 30 crédits gratuits pour l’essayer d’abord dans le Playground.

Paramètres de requête

Paramètre	Requis	Description
`bgm`	Non	Add background music to the clip. Separate from generate_audio, which covers the sound of the scene itself. 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 · 720p · 1080p · Par défaut: 720p
`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
resolution 540p	10,5	0,11 $US
resolution 720p	22,5	0,23 $US
resolution 1080p	24	0,24 $US

Chaque tâche est arrondie au crédit entier supérieur : une exécution au palier le plus bas coûte donc 53 crédits pour un clip de 5 secondes (0,53 $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 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/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/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",
    "duration_seconds": 5,
    "resolution": "720p",
    "movement_amplitude": "auto"
  }
}'

# 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

Combien coûte l’API Vidu Q3 ?

Vidu Q3 coûte 53 crédits (0,53 $US) pour un clip de 5 secondes. Prix par option : 540p 10,5 crédits par seconde, 720p 22,5 crédits par seconde, 1080p 24 crédits par seconde. 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 dans l’API ?

Indiquez vidu/q3/image-to-video pour Image vers vidéo dans le champ model de POST /jobs/createTask.

Quelles résolutions Vidu Q3 prend-il en charge ?

540p, 720p et 1080p, avec 720p par défaut. La méthode fiable consiste à trouver le mouvement en 540p, puis à relancer la prise validée en 1080p avec la même image et le même seed.

Puis-je générer à partir du texte seul ?

Pas dans cette famille. Vidu Q3 n’est publié qu’en image-to-video, chaque requête a donc besoin de image_url. Si vous partez d’une idée écrite, générez d’abord l’image de départ avec un modèle d’image, validez-la, puis animez-la ici.

Comment régler le ratio d’image ?

Par l’image que vous envoyez. Cet endpoint n’a pas de paramètre de ratio : une image en 16:9 donne un clip en 16:9, une image en 9:16 un clip vertical. Recadrez donc l’image avant de l’envoyer.

Est-ce que le son est généré ?

Oui. generate_audio vaut true par défaut : l’ambiance et les bruitages arrivent synchronisés avec l’image. Passez-le à false pour un clip muet. Les modèles Q3 n’ont pas d’interrupteur distinct pour une piste musicale : décrivez la musique voulue dans le prompt.

Comment Vidu Q3 est-il facturé ?

À la durée de sortie, en tenant compte de la résolution. L’estimation en direct affichée avant l’envoi reflète la durée et la résolution exactes de votre requête.