Créer une vidéo Flux 3

POST

videos

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Créez une vidéo Flux 3 à partir de texte, d’images de référence ou de première et dernière images. Stockez le id renvoyé afin d’interroger la tâche et de télécharger la vidéo terminée. POST /v1/videos utilise multipart/form-data. Envoyez les contrôles en tant que champs de formulaire. Pour les entrées d’image, utilisez des URL d’images de référence ou des images d’ouverture et de fermeture. Gardez input_reference distinct de first_frame et de last_frame.

Choisir un mode d’entrée

Objectif	Champs obligatoires	Champs facultatifs
Texte vers vidéo	`model=flux-3`, `prompt`	`seconds`, `size`
Image vers vidéo HTTPS	`model=flux-3`, `prompt`, une URL `input_reference`	`seconds`, `size`
Images clés ordonnées	`model=flux-3`, `prompt`, URL `input_reference` répétées	`seconds`, `size`
Image d’ouverture importée	`model=flux-3`, `prompt`, un fichier `first_frame`	`seconds`, `size`
Vidéo avec première et dernière images	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Utiliser des images de référence

Le champ input_reference accepte uniquement des URL d’images HTTPS accessibles publiquement. Envoyez-le une fois pour une seule image ou répétez-le dans l’ordre des images clés pour plusieurs images. Utilisez une URL par champ, jusqu’à 10 URL au total. Décrivez le mouvement, le comportement de la caméra et les détails visuels que la vidéo générée doit préserver à partir de l’image de référence. Les exemples de requêtes en haut de cette page montrent des entrées avec une seule image et plusieurs images. La requête suivante utilise deux images dans l’ordre où elles ont été envoyées :

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=Move smoothly through the supplied reference images in their given order. Preserve recognizable subjects and visual details as the scene changes. Keep the camera movement gentle.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569429.png' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569420.png'

Définir la première et la dernière images

Envoyez first_frame pour définir l’image d’ouverture. Pour également définir l’image de fermeture, incluez last_frame et décrivez le mouvement entre les deux images dans prompt. Pour une image d’ouverture seule, omettez last_frame. Une image de fermeture nécessite à la fois first_frame et last_frame. Chaque champ accepte une URL HTTPS accessible publiquement ou un fichier PNG ou JPEG. Envoyez chaque champ une seule fois, à l’aide d’une URL ou d’un fichier. Chaque fichier doit avoir une taille inférieure ou égale à 20 MiB (20 × 1024 × 1024 octets). Les exemples d’images en haut de cette page montrent des entrées d’URL et des importations de fichiers, avec seconds et size définis explicitement.

Définir la durée et la taille

Définissez explicitement seconds sur un entier compris entre 5 et 20. Définissez size sur l’une de ces valeurs prédéfinies WxH exactes :

Niveau de résolution	Taille
`720p`	`1280x720`
`1080p`	`1920x1080`

La valeur de taille sélectionne le niveau de résolution de sortie. Pour le texte vers vidéo, les dimensions encodées peuvent être ajustées pour l’alignement du codec. Pour l’image vers vidéo, l’image de référence peut également déterminer le cadrage final et le rapport hauteur/largeur.

Flux de la tâche

Créer la tâche

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

Interroger la tâche

Appelez Récupérer une vidéo Flux 3 jusqu’à ce que status soit completed ou failed.

Télécharger le résultat

Lorsque la tâche est completed, appelez Télécharger le contenu vidéo Flux 3 pour enregistrer le fichier MP4.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data

Flux 3 multipart request. Choose text, input_reference URLs, or first_frame and last_frame inputs. Keep reference-image and frame inputs separate.

model

string

défaut:flux-3

requis

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

défaut:A paper boat glides across a still pond while the camera moves forward.

requis

Text that describes the scene, motion, camera behavior, and visual details that the video should preserve.

Minimum string length: 1

seconds

integer

Requested clip duration in whole seconds. Set seconds explicitly to an integer from 5 through 20.

Plage requise: 5 <= x <= 20

size

enum<string>

défaut:1280x720

Resolution preset in exact WxH form. Use 1280x720 for the 720p tier or 1920x1080 for the 1080p tier. Encoded dimensions can be codec-aligned; image-to-video framing can follow the reference image.

Options disponibles:

1280x720,

1920x1080

input_reference

Reference image URLs. Send one publicly accessible HTTPS image URL per input_reference field. For multiple images, repeat the field in keyframe order, up to 10 URLs. This field accepts URLs only. Keep it separate from first_frame and last_frame.

Pattern: ^https://

first_frame

Opening-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. Pair with last_frame to set both boundaries. Keep frame inputs separate from input_reference.

Pattern: ^https://

last_frame

Closing-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. To specify the closing image through this endpoint, send last_frame together with first_frame. Keep frame inputs separate from input_reference.

Pattern: ^https://

Réponse

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

string

requis

Task ID. Use this value as task_id in retrieve and content requests.

Exemple:

"<task_id>"

object

string

requis

Object type for the asynchronous video task.

Allowed value: "video"

model

string

requis

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

requis

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

Options disponibles:

queued,

in_progress,

completed,

failed

progress

integer

requis

Task progress as a coarse percentage.

Plage requise: 0 <= x <= 100

created_at

integer<int64>

requis

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

Exemple:

"<task_id>"

completed_at

integer<int64>

Task completion time as a Unix timestamp in seconds when the task provides one.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

Exemple:

"https://media.example.com/flux-3-result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Dernière modification le 9 septembre 2026

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "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 première et la dernière images

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 première et la dernière images

​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 première et la dernière images

Définir la durée et la taille

Flux de la tâche