Skip to main content
POST
cURL
Utilisez ce endpoint bêta pour créer une tâche vidéo Omni. L’API renvoie immédiatement un ID de tâche, alors stockez l’id renvoyé et interrogez la tâche jusqu’à ce qu’elle atteigne un statut terminal. Bêta POST /v1/videos utilise multipart/form-data ; transmettez les contrôles scalaires comme champs de formulaire.

Choisir un mode d’entrée

Utilisez model=omni-fast pour cette page.

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

Omni est indiqué comme bêta, car la stabilité de génération peut varier selon l’entrée et la route sélectionnée. Gardez la première requête légère, puis inspectez la vidéo terminée avant de vous appuyer sur une durée de rendu ou une taille d’image spécifique. Comme ce endpoint est en 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 dépendre des pixels finaux.

Flux de tâche

1

Créer la tâche

Envoyez la requête de formulaire multipart et stockez l’id renvoyé.
2

Interroger la tâche

Appelez Retrieve an Omni video jusqu’à ce que status soit completed ou failed.
3

Télécharger le résultat

Lorsque la tâche est completed, appelez Retrieve Omni video content pour télécharger le fichier MP4.

Autorisations

Authorization
string
header
requis

Bearer authentication. Use your CometAPI API key.

Corps

multipart/form-data
model
enum<string>
requis

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

Options disponibles:
omni-fast
Exemple:

"omni-fast"

prompt
string
requis

Text prompt that describes the video to generate.

Exemple:

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

seconds
string
défaut:4

Requested clip duration in seconds. Start with 4 while this endpoint is beta.

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. 1080p can be accepted but current production output may normalize to 720p.

Exemple:

"720p"

Réponse

200 - application/json

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

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.