Criar um vídeo Veo 3

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

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

Crie um vídeo Veo 3.1 a partir de texto ou de uma imagem. A API retorna imediatamente um ID de tarefa. Armazene o id retornado para consultar a tarefa e baixar o vídeo concluído. POST /v1/videos usa multipart/form-data. Envie os controles como campos de formulário e uma imagem como um campo de arquivo input_reference.

Escolha um modelo

ID do modelo	Quando usá-lo	Observações
`veo3.1-fast`	Opção padrão para a maioria dos clipes curtos	Rota Veo 3.1 mais rápida.
`veo3.1`	Use quando quiser especificamente o modelo Veo 3.1 padrão	Rota Veo 3.1 padrão.

Escolha um modo de entrada

Objetivo	Campos obrigatórios	Campos opcionais
Texto para vídeo	`model`, `prompt`	`seconds`, `size`
Imagem para vídeo	`model`, `prompt`, um arquivo de imagem `input_reference`	`seconds`, `size`

Para animar uma imagem, envie um arquivo por meio de input_reference, usando o campo uma única vez. A imagem define o quadro inicial; prompt descreve o movimento e o comportamento da câmera subsequentes.

Defina a duração e o tamanho

Para esta rota compatível com OpenAI, defina a duração com um valor inteiro explícito de seconds e o tamanho de saída com size. Envie ambos os valores como campos de formulário.

ID do modelo	`seconds`	Padrão
`veo3.1-fast`	`4`, `6`, `8`	`4` segundos, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` segundos, `1280x720`

Defina size como um dos valores WxH abaixo.

Nível de resolução	Proporção de aspecto	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Fluxo da tarefa

Criar a tarefa

Envie a solicitação de formulário multipart e armazene o id retornado.

Consultar a tarefa

Use Veo3 Retrieve até que status seja completed, failed ou error.

Baixar o resultado

Quando a tarefa estiver completed, baixe o arquivo MP4 da resposta da tarefa concluída.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

model

enum<string>

obrigatório

Veo 3.1 model ID. Use veo3.1-fast for the default route or veo3.1 when you specifically need the standard model.

Opções disponíveis:

veo3.1-fast,

veo3.1

Exemplo:

"veo3.1-fast"

prompt

string

obrigatório

Text prompt for the video job.

Exemplo:

"A paper kite floats above a field."

seconds

enum<integer>

padrão:4

Requested clip duration in whole seconds. Send 4, 6, or 8 as a form field.

Opções disponíveis:

4,

6,

8

Exemplo:

4

size

string

Supported WxH size values: 1280x720, 720x1280, 1920x1080, 3840x2160. Default is 1280x720.

Exemplo:

"1280x720"

input_reference

file

One image file that sets the opening frame for image-to-video. Send input_reference once with one file. Use prompt to describe the motion and camera behavior that follow.

Resposta

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

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

Última modificação em 9 de setembro de 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=veo3.1-fast \
  -F 'prompt=A paper kite floats above a field.' \
  -F seconds=4 \
  -F size=1280x720

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

Moderação de conteúdo

Chaves de API

Escolha um modelo

Escolha um modo de entrada

Defina a duração e o tamanho

Fluxo da tarefa

Autorizações

Corpo

Resposta

​Escolha um modelo

​Escolha um modo de entrada

​Defina a duração e o tamanho

​Fluxo da tarefa

Autorizações

Corpo

Resposta

Escolha um modelo

Escolha um modo de entrada

Defina a duração e o tamanho

Fluxo da tarefa