Crie um vídeo Omni a partir de texto, imagem ou vídeo

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
}

Use este endpoint beta para criar uma tarefa de texto para vídeo, imagem para vídeo ou vídeo para vídeo. A API retorna um ID de tarefa imediatamente, portanto armazene o id retornado e consulte a tarefa até que ela alcance um status terminal. Escolha o tipo de conteúdo da solicitação que corresponde ao modo de entrada. Envie os controles de texto para vídeo e imagem para vídeo como campos multipart/form-data. Envie uma edição de vídeo de referência como um corpo application/json.

Escolha um modo de entrada

Objetivo	Tipo de conteúdo	Campos obrigatórios	Campos opcionais
Texto para vídeo	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Imagem para vídeo	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Vídeo para vídeo	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Os exemplos de texto para vídeo e imagem para vídeo usam model=omni-fast. Os exemplos de vídeo para vídeo usam model=omni-fast-v2v. Use Listar modelos disponíveis para confirmar que um ID de modelo está visível para sua chave de API.

Anime uma imagem de referência

Para imagem para vídeo, use model=omni-fast e envie um arquivo PNG no campo multipart input_reference. O campo permanece opcional para texto para vídeo, mas é obrigatório quando uma imagem de referência deve orientar o vídeo gerado. Concentre o prompt no movimento a ser adicionado e nomeie explicitamente as cores, formas, temas ou composição que o resultado deve preservar. O seletor de exemplos de código inclui exemplos em Shell, Python e JavaScript que enviam reference.png do diretório de trabalho e criam a tarefa. Este formato de solicitação abrange um PNG enviado. Ele não define entrada por URL, outros formatos de imagem, várias imagens de referência nem limites de tamanho de arquivo.

Edite um vídeo de referência

Para vídeo para vídeo, codifique um arquivo MP4 local em base64 e adicione o prefixo data:video/mp4;base64, aos bytes codificados. Envie a URL de dados completa no campo video. Descreva as alterações solicitadas em prompt. Também nomeie os temas, objetos, composição ou movimento que o resultado deve preservar. O seletor de exemplos de código inclui exemplos em Shell, Python e JavaScript que leem reference.mp4 do diretório de trabalho. Este formato de solicitação abrange uma URL de dados MP4 embutida. Ele não define entrada por URL, outros formatos de contêiner de vídeo nem limites de tamanho de arquivo.

Defina duração, proporção e resolução

O Omni é marcado como beta porque a estabilidade da geração pode variar conforme a entrada e a rota selecionada. Mantenha a primeira solicitação pequena e, em seguida, inspecione o vídeo concluído antes de depender de uma duração renderizada ou tamanho de quadro específicos.

Configuração	Valores compatíveis	Padrão	Comportamento nos limites
`seconds`	Comece com `4`	Dependente da rota	Trate isso como uma duração solicitada e verifique o MP4 concluído, pois a duração de saída pode ser diferente.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` pode renderizar saída em retrato. `1:1` pode ser aceito durante a renderização em paisagem.
`resolution`	Comece com `720p`; `1080p` pode ser aceito	`720p`	A saída de produção atual pode ser normalizada para `720p` mesmo quando `1080p` é solicitado.

Solicitação	Quadro concluído 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`

Como este endpoint está em beta, trate aspect_ratio e resolution como preferências de geração e verifique o MP4 baixado antes de depender dos pixels finais.

Fluxo da tarefa

Crie a tarefa

Envie a solicitação com o tipo de conteúdo para o modo de entrada selecionado e armazene o id retornado.

Consulte a tarefa

Chame Recuperar um vídeo Omni até que status seja completed ou failed.

Baixe o resultado

Quando a tarefa estiver completed, chame Recuperar conteúdo de vídeo Omni para baixar o arquivo MP4.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication. Use your CometAPI API key.

Corpo

model

string

obrigatório

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

Exemplo:

"omni-fast"

prompt

string

obrigatório

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

Exemplo:

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

Exemplo:

"4"

aspect_ratio

enum<string>

padrão: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.

Opções disponíveis:

16:9,

9:16,

1:1

Exemplo:

"16:9"

resolution

string

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

Exemplo:

"720p"

Resposta

200 - application/json

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

string

obrigatório

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

Exemplo:

"task_example"

object

string

obrigatório

Object type. Video tasks return video.

Exemplo:

"video"

model

string

obrigatório

Model ID used for the task.

Exemplo:

"omni-fast"

status

enum<string>

obrigatório

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

Opções disponíveis:

queued,

in_progress,

completed,

failed,

error

Exemplo:

"queued"

progress

integer

obrigatório

Task progress as a coarse percentage.

Intervalo necessário: 0 <= x <= 100

Exemplo:

0

created_at

integer

obrigatório

Task creation time as a Unix timestamp in seconds.

Exemplo:

1779938152

task_id

string

Compatibility alias for id when present.

Exemplo:

"task_example"

completed_at

integer

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

Exemplo:

1779938219

video_url

string

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

Exemplo:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Show child attributes

Última modificação em 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
}

Moderação de conteúdo

Chaves de API

Crie um vídeo Omni a partir de texto, imagem ou vídeo

Escolha um modo de entrada

Anime uma imagem de referência

Edite um vídeo de referência

Defina duração, proporção e resolução

Fluxo da tarefa

Autorizações

Corpo

Resposta

​Escolha um modo de entrada

​Anime uma imagem de referência

​Edite um vídeo de referência

​Defina duração, proporção e resolução

​Fluxo da tarefa

Autorizações

Corpo

Resposta

Escolha um modo de entrada

Anime uma imagem de referência

Edite um vídeo de referência

Defina duração, proporção e resolução

Fluxo da tarefa