Crea un video Omni a partir de texto, imagen o video

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
}

Usa este endpoint beta para crear una tarea de texto a video, imagen a video o video a video. La API devuelve un ID de tarea de inmediato, así que guarda el id devuelto y consulta la tarea hasta que alcance un estado final. Elige el tipo de contenido de la solicitud que corresponda al modo de entrada. Envía los controles de texto a video e imagen a video como campos multipart/form-data. Envía una edición de video de referencia como un cuerpo application/json.

Elige un modo de entrada

Objetivo	Tipo de contenido	Campos obligatorios	Campos opcionales
Texto a video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Imagen a video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Video a video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Los ejemplos de texto a video e imagen a video usan model=omni-fast. Los ejemplos de video a video usan model=omni-fast-v2v. Usa Listar modelos disponibles para confirmar que un ID de modelo sea visible para tu clave de API.

Anima una imagen de referencia

Para imagen a video, usa model=omni-fast y carga un archivo PNG en el campo multipart input_reference. El campo sigue siendo opcional para texto a video, pero es obligatorio cuando una imagen de referencia debe guiar el video generado. Centra el prompt en el movimiento que se debe añadir y menciona explícitamente los colores, las formas, los sujetos o la composición que el resultado debe conservar. El selector de ejemplos de código incluye ejemplos de Shell, Python y JavaScript que cargan reference.png desde el directorio de trabajo y crean la tarea. Esta estructura de solicitud cubre un archivo PNG cargado. No define la entrada mediante URL, otros formatos de imagen, varias imágenes de referencia ni límites de tamaño de archivo.

Edita un video de referencia

Para video a video, codifica un archivo MP4 local en base64 y antepone a los bytes codificados data:video/mp4;base64,. Envía la URL de datos completa en el campo video. Describe los cambios solicitados en prompt. Menciona también los sujetos, objetos, la composición o el movimiento que el resultado debe conservar. El selector de ejemplos de código incluye ejemplos de Shell, Python y JavaScript que leen reference.mp4 desde el directorio de trabajo. Esta estructura de solicitud cubre una URL de datos MP4 insertada. No define la entrada mediante URL, otros formatos de contenedor de video ni límites de tamaño de archivo.

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

Omni se marca como beta porque la estabilidad de la generación puede variar según la entrada y la ruta seleccionada. Mantenga pequeña la primera solicitud y, después, inspeccione el video completado antes de depender de una duración renderizada o un tamaño de fotograma específicos.

Configuración	Valores admitidos	Predeterminado	Comportamiento en los límites
`seconds`	Comience con `4`	Depende de la ruta	Considere esto como una duración solicitada y verifique el MP4 completado, ya que la duración de salida puede diferir.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` puede generar salida en formato vertical. `1:1` se puede aceptar mientras se renderiza en formato horizontal.
`resolution`	Comience con `720p`; se puede aceptar `1080p`	`720p`	La salida de producción actual puede normalizarse a `720p` incluso cuando se solicita `1080p`.

Solicitud	Fotograma completado observado
`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`

Dado que este endpoint está en beta, considere aspect_ratio y resolution como preferencias de generación y verifique el MP4 descargado antes de depender de los píxeles finales.

Flujo de tareas

Crear la tarea

Envíe la solicitud con el tipo de contenido correspondiente al modo de entrada seleccionado y almacene el valor id devuelto.

Consultar la tarea

Llame a Recuperar un video de Omni hasta que status sea completed o failed.

Descargar el resultado

Cuando la tarea esté completed, llame a Recuperar contenido de video de Omni para descargar el archivo MP4.

Autorizaciones

Authorization

string

header

requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

model

string

requerido

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

Ejemplo:

"omni-fast"

prompt

string

requerido

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

Ejemplo:

"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.

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. A request for 1080p can render at 720p.

Ejemplo:

"720p"

Respuesta

200 - application/json

Task accepted. Store the returned id and poll GET /v1/videos/{task_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.

Show child attributes

Última modificación el 4 de agosto de 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
}

Moderación de contenido

Claves API

Crea un video Omni a partir de texto, imagen o video

Elige un modo de entrada

Anima una imagen de referencia

Edita un video de referencia

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

Flujo de tareas

Autorizaciones

Cuerpo

Respuesta

​Elige un modo de entrada

​Anima una imagen de referencia

​Edita un video de referencia

​Establecer la duración, la proporción y la resolución

​Flujo de tareas

Autorizaciones

Cuerpo

Respuesta

Elige un modo de entrada

Anima una imagen de referencia

Edita un video de referencia

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

Flujo de tareas