Créer une vidéo Vidu

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Utilisez ce point de terminaison pour créer une tâche Vidu Q3 de texte à vidéo ou d’image à vidéo. L’API renvoie immédiatement un ID de tâche. Stockez donc la valeur id renvoyée et interrogez la tâche jusqu’à ce qu’elle atteigne un statut terminal. POST /v1/videos utilise multipart/form-data. Envoyez les contrôles scalaires sous forme de champs de formulaire et les images de référence sous forme de champs de fichier input_reference.

Choisir un mode d’entrée

Objectif	Champs obligatoires	Champs facultatifs
Texte à vidéo	`model`, `prompt`	`seconds`, `size`
Image à vidéo	`model`, `prompt`, un fichier `input_reference`	`seconds`, `size`

Pour confirmer qu’un ID de modèle Vidu est disponible pour votre clé API, utilisez Lister les modèles disponibles.

Utiliser des images de référence

Pour l’image à vidéo, téléversez une image de référence via le champ multipart input_reference. Le fichier peut peser jusqu’à 20 Mo. L’image guide la composition et l’apparence de la vidéo générée. Utilisez le prompt pour décrire le mouvement, le comportement de la caméra et les détails que la vidéo doit préserver.

Définir la durée et la taille

ID du modèle	`seconds`	Valeur par défaut
`viduq3-turbo`	entier `1`-`16`	`5` secondes, `1280x720`
`viduq3`	entier `1`-`16`	`5` secondes, `1280x720`

Définissez size sur l’une des valeurs WxH ci-dessous.

Niveau de résolution	Format d’image	`size` (`WxH`)
`540p`	`16:9`	`960x528`
`720p`	`16:9`	`1280x720`
`1080p`	`16:9`	`1920x1080`

Flux de la tâche

Créer la tâche

Envoyez la requête de formulaire multipart et stockez la valeur id renvoyée.

Interroger la tâche

Appelez Récupérer une vidéo Vidu jusqu’à ce que status soit completed, failed ou error.

Télécharger le résultat

Lorsque la tâche est completed, appelez Récupérer le contenu de la vidéo Vidu pour télécharger le fichier MP4.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data

model

string

requis

Vidu Q3 model ID for this route. Choose an available model from the Models page.

Exemple:

"viduq3-turbo"

prompt

string

requis

Text prompt that describes the video to generate. For image-to-video, describe the motion and camera behavior that should animate the reference image.

Exemple:

"An astronaut walks through soft blue fog with a slow cinematic camera move."

seconds

string

Requested clip duration in seconds. Use an integer from 1 through 16. Default is 5.

Exemple:

"1"

size

string

Supported WxH size values: 960x528, 1280x720, 1920x1080. Default is 1280x720.

input_reference

file

One reference image file for image-to-video. Omit this field for text-to-video. The file can be up to 20 MB. The image guides the composition and appearance of the generated video.

Réponse

Task created. Store the returned id and poll GET /v1/videos/{task_id}.

string

requis

Task ID. Use this value with retrieve and content endpoints.

Exemple:

"task_example"

object

string

requis

Object type. Video tasks return video.

Exemple:

"video"

model

string

requis

Model ID used for the task.

Exemple:

"viduq3-turbo"

status

enum<string>

requis

Task lifecycle status. Poll until the value is completed, failed, or error.

Options disponibles:

queued,

in_progress,

completed,

failed,

error

Exemple:

"queued"

progress

integer

requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100

Exemple:

0

created_at

integer

requis

Task creation time as a Unix timestamp in seconds.

Exemple:

1779938152

task_id

string

Compatibility alias for id when present.

Exemple:

"task_example"

completed_at

integer

Task completion time as a Unix timestamp in seconds. This field appears on completed tasks.

Exemple:

1779938219

video_url

string

Temporary video delivery URL. This field appears on completed tasks.

Exemple:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Dernière modification le 12 août 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=viduq3-turbo \
  -F 'prompt=An astronaut walks through soft blue fog with a slow cinematic camera move.' \
  -F seconds=1

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "viduq3-turbo",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Modération de contenu

Clés API

Choisir un mode d’entrée

Utiliser des images de référence

Définir la durée et la taille

Flux de la tâche

Autorisations

Corps

Réponse

​Choisir un mode d’entrée

​Utiliser des images de référence

​Définir la durée et la taille

​Flux de la tâche

Autorisations

Corps

Réponse

Choisir un mode d’entrée

Utiliser des images de référence

Définir la durée et la taille

Flux de la tâche