Criar um vídeo Flux 3

POST

videos

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Crie um vídeo Flux 3 a partir de texto, imagens de referência ou primeiro e último quadros. 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. Para entradas de imagem, use URLs de imagens de referência ou quadros de abertura e fechamento. Mantenha input_reference separado de first_frame e last_frame.

Escolha um modo de entrada

Objetivo	Campos obrigatórios	Campos opcionais
Texto para vídeo	`model=flux-3`, `prompt`	`seconds`, `size`
Imagem para vídeo via HTTPS	`model=flux-3`, `prompt`, uma URL `input_reference`	`seconds`, `size`
Quadros-chave ordenados	`model=flux-3`, `prompt`, URLs `input_reference` repetidas	`seconds`, `size`
Quadro de abertura enviado	`model=flux-3`, `prompt`, um arquivo `first_frame`	`seconds`, `size`
Vídeo com primeiro e último quadro	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Usar imagens de referência

O campo input_reference aceita apenas URLs HTTPS de imagens acessíveis publicamente. Envie-o uma vez para uma única imagem ou repita-o na ordem dos quadros-chave para várias imagens. Use uma URL por campo, com até 10 URLs no total. Descreva o movimento, o comportamento da câmera e os detalhes visuais que o vídeo gerado deve preservar da imagem de referência. Os exemplos de solicitação no início desta página mostram entradas de uma única imagem e de várias imagens. A solicitação a seguir usa duas imagens na ordem em que foram enviadas:

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=Move smoothly through the supplied reference images in their given order. Preserve recognizable subjects and visual details as the scene changes. Keep the camera movement gentle.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569429.png' \
  --form-string 'input_reference=https://apidoc.cometapi.com/images/image/gemini/6100640_569420.png'

Definir o primeiro e o último quadros

Envie first_frame para definir a imagem de abertura. Para também definir a imagem de fechamento, inclua last_frame e descreva o movimento entre os dois quadros em prompt. Para apenas um quadro de abertura, omita last_frame. Um quadro de fechamento requer first_frame e last_frame. Cada campo aceita uma URL HTTPS acessível publicamente ou um arquivo PNG ou JPEG. Envie cada campo uma vez, usando uma URL ou um arquivo. Mantenha cada arquivo com tamanho máximo de 20 MiB (20 × 1024 × 1024 bytes). Os exemplos de quadros no início desta página mostram entradas de URL e uploads de arquivos, com seconds e size definidos explicitamente.

Definir duração e tamanho

Defina seconds explicitamente como um inteiro de 5 a 20. Defina size como um destes valores predefinidos exatos de WxH:

Nível de resolução	Tamanho
`720p`	`1280x720`
`1080p`	`1920x1080`

O valor de tamanho seleciona o nível de resolução de saída. Para vídeo a partir de texto, as dimensões codificadas podem ser ajustadas para alinhamento de codec. Para vídeo a partir de imagem, a imagem de referência também pode determinar o enquadramento final e a proporção de aspecto.

Fluxo da tarefa

Criar a tarefa

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

Consultar a tarefa

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

Baixar o resultado

Quando a tarefa estiver completed, chame Baixar conteúdo de vídeo Flux 3 para salvar o arquivo MP4.

Autorizações

Authorization

string

header

obrigatório

Bearer authentication. Use your CometAPI API key.

Corpo

multipart/form-data

Flux 3 multipart request. Choose text, input_reference URLs, or first_frame and last_frame inputs. Keep reference-image and frame inputs separate.

model

string

padrão:flux-3

obrigatório

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

padrão:A paper boat glides across a still pond while the camera moves forward.

obrigatório

Text that describes the scene, motion, camera behavior, and visual details that the video should preserve.

Minimum string length: 1

seconds

integer

Requested clip duration in whole seconds. Set seconds explicitly to an integer from 5 through 20.

Intervalo necessário: 5 <= x <= 20

size

enum<string>

padrão:1280x720

Resolution preset in exact WxH form. Use 1280x720 for the 720p tier or 1920x1080 for the 1080p tier. Encoded dimensions can be codec-aligned; image-to-video framing can follow the reference image.

Opções disponíveis:

1280x720,

1920x1080

input_reference

Reference image URLs. Send one publicly accessible HTTPS image URL per input_reference field. For multiple images, repeat the field in keyframe order, up to 10 URLs. This field accepts URLs only. Keep it separate from first_frame and last_frame.

Pattern: ^https://

first_frame

Opening-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. Pair with last_frame to set both boundaries. Keep frame inputs separate from input_reference.

Pattern: ^https://

last_frame

Closing-frame image as one publicly accessible HTTPS URL or one PNG or JPEG file. Keep each file at or below 20 MiB (20 × 1024 × 1024 bytes). Send the field once, using either a URL or a file. To specify the closing image through this endpoint, send last_frame together with first_frame. Keep frame inputs separate from input_reference.

Pattern: ^https://

Resposta

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

string

obrigatório

Task ID. Use this value as task_id in retrieve and content requests.

Exemplo:

"<task_id>"

object

string

obrigatório

Object type for the asynchronous video task.

Allowed value: "video"

model

string

obrigatório

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

obrigatório

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

Opções disponíveis:

queued,

in_progress,

completed,

failed

progress

integer

obrigatório

Task progress as a coarse percentage.

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

created_at

integer<int64>

obrigatório

Task creation time as a Unix timestamp in seconds.

task_id

string

Compatibility alias for id. This field can be omitted from retrieve responses.

Exemplo:

"<task_id>"

completed_at

integer<int64>

Task completion time as a Unix timestamp in seconds when the task provides one.

expires_at

integer<int64>

Result expiration time as a Unix timestamp in seconds when the task provides one.

video_url

string<uri>

Video delivery URL. This field appears on completed tasks.

Exemplo:

"https://media.example.com/flux-3-result.mp4"

error

object

Failure details. This field appears when the task fails.

Show child attributes

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

curl \
  https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  --form-string 'model=flux-3' \
  --form-string 'prompt=A paper boat glides across a still pond while the camera moves forward.' \
  --form-string 'seconds=5' \
  --form-string 'size=1280x720'

{
  "id": "<task_id>",
  "task_id": "<task_id>",
  "object": "video",
  "model": "flux-3",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Moderação de conteúdo

Chaves de API

Escolha um modo de entrada

Usar imagens de referência

Definir o primeiro e o último quadros

Definir duração e tamanho

Fluxo da tarefa

Autorizações

Corpo

Resposta

​Escolha um modo de entrada

​Usar imagens de referência

​Definir o primeiro e o último quadros

​Definir duração e tamanho

​Fluxo da tarefa

Autorizações

Corpo

Resposta

Escolha um modo de entrada

Usar imagens de referência

Definir o primeiro e o último quadros

Definir duração e tamanho

Fluxo da tarefa