Créer une vidéo Omni à partir de texte, d’une image ou d’une vidéo

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

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

Utilisez ce point de terminaison bêta pour créer une tâche de conversion de texte en vidéo, d’image en vidéo ou de vidéo en vidéo. L’API renvoie immédiatement un ID de tâche ; stockez donc le id renvoyé et interrogez la tâche jusqu’à ce qu’elle atteigne un statut terminal. Choisissez le type de contenu de la requête correspondant au mode d’entrée. Envoyez les contrôles de conversion de texte en vidéo et d’image en vidéo sous forme de champs multipart/form-data. Envoyez une modification de vidéo de référence sous forme de corps application/json.

Choisir un mode d’entrée

Objectif	Type de contenu	Champs obligatoires	Champs facultatifs
Conversion de texte en vidéo	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Conversion d’image en vidéo	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Conversion de vidéo en vidéo	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Les exemples de conversion de texte en vidéo et d’image en vidéo utilisent model=omni-fast. Les exemples de conversion de vidéo en vidéo utilisent model=omni-fast-v2v. Utilisez Lister les modèles disponibles pour confirmer qu’un ID de modèle est visible par votre clé API.

Animer une image de référence

Pour la conversion d’image en vidéo, utilisez model=omni-fast et chargez un fichier PNG dans le champ multipart input_reference. Ce champ reste facultatif pour la conversion de texte en vidéo, mais il est obligatoire lorsqu’une image de référence doit guider la vidéo générée. Concentrez le prompt sur le mouvement à ajouter et nommez explicitement les couleurs, formes, sujets ou la composition que le résultat doit préserver. Le sélecteur d’exemples de code comprend des exemples Shell, Python et JavaScript qui chargent reference.png depuis le répertoire de travail et créent la tâche. Cette structure de requête couvre un fichier PNG chargé. Elle ne définit pas l’entrée par URL, les autres formats d’image, plusieurs images de référence ni les limites de taille de fichier.

Modifier une vidéo de référence

Pour la conversion de vidéo en vidéo, encodez un fichier MP4 local en base64 et préfixez les octets encodés avec data:video/mp4;base64,. Envoyez l’URL de données complète dans le champ video. Décrivez les modifications demandées dans prompt. Indiquez également les sujets, objets, la composition ou le mouvement que le résultat doit préserver. Le sélecteur d’exemples de code comprend des exemples Shell, Python et JavaScript qui lisent reference.mp4 depuis le répertoire de travail. Cette structure de requête couvre une URL de données MP4 intégrée. Elle ne définit pas l’entrée par URL, les autres formats de conteneur vidéo ni les limites de taille de fichier.

Définir la durée, le ratio et la résolution

Omni est indiqué comme bêta, car la stabilité de la génération peut varier selon l’entrée et la route sélectionnée. Limitez la première requête, puis inspectez la vidéo terminée avant de vous fier à une durée rendue ou à une taille d’image spécifique.

Paramètre	Valeurs prises en charge	Valeur par défaut	Comportement aux limites
`seconds`	Commencez par `4`	Dépend de la route	Considérez ceci comme une durée demandée et vérifiez le MP4 terminé, car la durée de sortie peut différer.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` peut générer une sortie au format portrait. `1:1` peut être accepté tout en effectuant un rendu au format paysage.
`resolution`	Commencez par `720p` ; `1080p` peut être accepté	`720p`	La sortie de production actuelle peut être normalisée à `720p` même lorsque `1080p` est demandé.

Requête	Image finale observée
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Comme ce point de terminaison est bêta, considérez aspect_ratio et resolution comme des préférences de génération et vérifiez le MP4 téléchargé avant de vous fier aux pixels finaux.

Flux de tâches

Créer la tâche

Envoyez la requête avec le type de contenu correspondant au mode d’entrée sélectionné et enregistrez le id renvoyé.

Interroger la tâche

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

Télécharger le résultat

Lorsque la tâche est completed, appelez Récupérer le contenu d’une vidéo Omni pour télécharger le fichier MP4.

Autorisations

Authorization

string

header

requis

Bearer authentication. Use your CometAPI API key.

Corps

model

string

requis

Omni model ID for this endpoint. Use omni-fast for text-to-video and image-to-video.

Exemple:

"omni-fast"

prompt

string

requis

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Exemple:

"Ocean waves rolling onto a sandy beach at golden hour"

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Exemple:

"4"

aspect_ratio

enum<string>

défaut:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

Options disponibles:

16:9,

9:16,

1:1

Exemple:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Exemple:

"720p"

Réponse

200 - application/json

Task accepted. 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:

"omni-fast"

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.

Show child attributes

Dernière modification le 4 août 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

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

Modération de contenu

Clés API

Créer une vidéo Omni à partir de texte, d’une image ou d’une vidéo

Choisir un mode d’entrée

Animer une image de référence

Modifier une vidéo de référence

Définir la durée, le ratio et la résolution

Flux de tâches

Autorisations

Corps

Réponse

​Choisir un mode d’entrée

​Animer une image de référence

​Modifier une vidéo de référence

​Définir la durée, le ratio et la résolution

​Flux de tâches

Autorisations

Corps

Réponse

Choisir un mode d’entrée

Animer une image de référence

Modifier une vidéo de référence

Définir la durée, le ratio et la résolution

Flux de tâches