Référence API de Vidu Q4 Preview

Une seule clé API PopNow suffit pour appeler Vidu Q4 Preview depuis votre code. Vous trouverez ici les identifiants de modèle à envoyer, chaque champ d’entrée accepté, le coût d’une requête en crédits et une requête à coller telle quelle dans un terminal.

Les descriptions des paramètres proviennent du schéma d’entrée du modèle et ne sont disponibles qu’en anglais.

En bref

Éditeur: Vidu
Résultat: Vidéo
À partir de: 6.75 crédits par seconde produite ($0.0675)
Durée habituelle: environ 160 s
Identifiants de modèle: vidu/q4-preview/image-to-video
vidu/q4-preview/reference-to-video
vidu/q4-preview/video-extend

1 crédit = 0,01 $. À l’acceptation, une tâche réserve le montant maximal possible, puis facture la consommation réelle à la fin, arrondie au crédit supérieur ; le reste est libéré. Une tâche en échec n’est pas facturée. Pour connaître le montant exact avant de lancer, appelez POST /api/v1/jobs/quote.

Image vers vidéo

vidu/q4-preview/image-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`540p`	6.75	$0.0675
`720p`	14.25	$0.1425
`1080p`	18	$0.18
`2k`	28.5	$0.285
`4k`	58.5	$0.585

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 20 000 caractères	Describe what happens after the opening frame: the action, the dialogue in quotes, the camera and the sound.
`image_url`Obligatoire	`string (uri)`	—	—	Opening frame. The clip starts from this image and keeps its shape.
`resolution`Facultatif	`string`	`720p`	540p, 720p, 1080p, 2k, 4k	Output resolution. 2k and 4k come back as 10-bit HEVC.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 16	Output length in whole seconds, from 3 to 16. Billed per second.
`generate_audio`Facultatif	`boolean`	`true`	—	Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	—	Let the model rewrite and expand your prompt before generating.
`seed`Facultatif	`integer`	—	de 0 à 2147483647	Random seed for controlled comparisons, not a frame-identical guarantee.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans image_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "vidu/q4-preview/image-to-video",
  "input": {
    "prompt": "He lands softly on the rooftop, laughs and turns toward the camera while the balloons sway in the evening breeze; slow push-in",
    "image_url": "https://media.popnow.ai/influencer/examples/marco.webp",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Références vers vidéo

vidu/q4-preview/reference-to-video

Prix

Option	Crédits (par seconde produite)	Dollars US
`540p`	6.75	$0.0675
`720p`	14.25	$0.1425
`1080p`	18	$0.18
`2k`	28.5	$0.285
`4k`	58.5	$0.585

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 20 000 caractères	Describe the scene and refer to each reference by its position: "the woman from the first image", "the robe from the second image".
`reference_image_urls`Obligatoire	`array<string (uri)>`	—	jusqu’à 15 éléments	One to 15 reference images: people, outfits, products or places, in the order your prompt refers to them.
`reference_audio_urls`Facultatif	`array<string (uri)>`	—	jusqu’à 3 éléments	Up to three reference audio clips (MP3, 3 to 12 seconds each) for a voice or a sound the clip should follow.
`aspect_ratio`Facultatif	`string`	`16:9`	16:9, 9:16, 1:1, 3:4, 4:3	Output aspect ratio.
`resolution`Facultatif	`string`	`720p`	540p, 720p, 1080p, 2k, 4k	Output resolution. 2k and 4k come back as 10-bit HEVC.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 16	Output length in whole seconds, from 3 to 16. Billed per second.
`generate_audio`Facultatif	`boolean`	`true`	—	Generate sound with the picture: dialogue, effects and ambience. Off gives a silent clip at the same price.
`seed`Facultatif	`integer`	—	de 0 à 2147483647	Random seed for controlled comparisons, not a frame-identical guarantee.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans reference_image_urls. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "vidu/q4-preview/reference-to-video",
  "input": {
    "prompt": "The man from the reference image jogs across a sunlit rooftop at golden hour and smiles at the camera; smooth tracking shot",
    "reference_image_urls": [
      "https://media.popnow.ai/influencer/examples/ava.webp"
    ],
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Prolonger une vidéo

vidu/q4-preview/video-extend

Prix

Option	Crédits (par seconde produite)	Dollars US
`540p`	6.75	$0.0675
`720p`	14.25	$0.1425
`1080p`	18	$0.18
`2k`	28.5	$0.285
`4k`	58.5	$0.585

Paramètres

Champ	Type	Valeur par défaut	Valeurs admises	Rôle
`prompt`Obligatoire	`string`	—	jusqu’à 20 000 caractères	Describe what happens next: the action that follows, the camera move and the sound. Put spoken lines in double quotes.
`video_url`Obligatoire	`string (uri)`	—	—	The clip to continue: MP4, MOV or WebM, up to 60 seconds. Its last frame opens the new segment, and the result is your clip with the new segment joined on.
`resolution`Facultatif	`string`	`720p`	540p, 720p, 1080p, 2k, 4k	Resolution of the generated new segment. It sets how sharp the new part is; match your source clip. 2k and 4k segments come back as 10-bit HEVC.
`duration_seconds`Facultatif	`integer`	`5`	de 3 à 16	Length of the new segment in seconds, from 3 to 16. The source clip is added on top and is not billed.
`generate_audio`Facultatif	`boolean`	`true`	—	Generate sound for the new segment. The source keeps its own sound either way.
`enable_prompt_expansion`Facultatif	`boolean`	`false`	—	Let the model rewrite and expand your prompt before generating.
`seed`Facultatif	`integer`	—	de 0 à 2147483647	Random seed. Keep it fixed only for controlled comparisons, not as a frame-identical guarantee.

Exemple de requête

Cette requête fonctionne telle quelle ; les champs omis gardent leur valeur par défaut. Placez d’abord votre clé dans POPNOW_API_KEY.

L’exemple utilise des fichiers d’exemple PopNow dans video_url. Remplacez-les par vos propres liens HTTPS publics, fichiers envoyés ou ressources enregistrées.

POST /api/v1/jobs/createTask

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: $(uuidgen)" \
  -d '{
  "model": "vidu/q4-preview/video-extend",
  "input": {
    "prompt": "The flowers keep opening while the camera slowly pulls back to reveal a sunlit meadow",
    "video_url": "https://media.popnow.ai/effects/flower-bloom-1abd6efb.mp4",
    "duration_seconds": 5,
    "resolution": "720p"
  }
}'

La réponse contient tout de suite un taskId. Récupérez le résultat avec GET /api/v1/jobs/recordInfo, ou ajoutez callBackUrl pour être prévenu.

GET /api/v1/jobs/recordInfo

curl "https://api.popnow.ai/api/v1/jobs/recordInfo?taskId=TASK_ID_FROM_CREATE_TASK" \
  -H "Authorization: Bearer $POPNOW_API_KEY"

Référence API de Vidu Q4 Preview

En bref

Image vers vidéo

Prix

Paramètres

Exemple de requête

Références vers vidéo

Prix

Paramètres

Exemple de requête

Prolonger une vidéo

Prix

Paramètres

Exemple de requête

Pour aller plus loin

Sur cette page