Skip to main content
POST
cURL
Usa este endpoint beta para crear una tarea de video Omni. La API devuelve un ID de tarea de inmediato, así que guarda el id devuelto y consulta la tarea hasta que alcance un estado terminal. Beta POST /v1/videos usa multipart/form-data; pasa los controles escalares como campos del formulario.

Elige un modo de entrada

Usa model=omni-fast para esta página.

Configura la duración, la proporción y la resolución

Omni está marcado como beta porque la estabilidad de la generación puede variar según la entrada y la ruta seleccionada. Mantén pequeña la primera solicitud y luego inspecciona el video completado antes de depender de una duración renderizada o un tamaño de fotograma específicos. Debido a que este endpoint está en beta, trata aspect_ratio y resolution como preferencias de generación y verifica el MP4 descargado antes de depender de los píxeles finales.

Flujo de la tarea

1

Crear la tarea

Envía la solicitud de formulario multipart y guarda el id devuelto.
2

Consultar la tarea

Llama a Retrieve an Omni video hasta que status sea completed o failed.
3

Descargar el resultado

Cuando la tarea esté completed, llama a Retrieve Omni video content para descargar el archivo MP4.

Autorizaciones

Authorization
string
header
requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

multipart/form-data
model
enum<string>
requerido

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

Opciones disponibles:
omni-fast
Ejemplo:

"omni-fast"

prompt
string
requerido

Text prompt that describes the video to generate.

Ejemplo:

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

seconds
string
predeterminado:4

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

Ejemplo:

"4"

aspect_ratio
enum<string>
predeterminado: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.

Opciones disponibles:
16:9,
9:16,
1:1
Ejemplo:

"16:9"

resolution
string

Output resolution preference. Start with 720p. 1080p can be accepted but current production output may normalize to 720p.

Ejemplo:

"720p"

Respuesta

200 - application/json

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

id
string
requerido

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

Ejemplo:

"task_example"

object
string
requerido

Object type. Video tasks return video.

Ejemplo:

"video"

model
string
requerido

Model ID used for the task.

Ejemplo:

"omni-fast"

status
enum<string>
requerido

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

Opciones disponibles:
queued,
in_progress,
completed,
failed,
error
Ejemplo:

"queued"

progress
integer
requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100
Ejemplo:

0

created_at
integer
requerido

Task creation time as a Unix timestamp in seconds.

Ejemplo:

1779938152

task_id
string

Compatibility alias for id when present.

Ejemplo:

"task_example"

completed_at
integer

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

Ejemplo:

1779938219

video_url
string

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

Ejemplo:

"<temporary-video-url>"

error
object

Failure details. This field appears when the task fails.