Crear un vídeo de 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
}

Cree un vídeo de Flux 3 a partir de texto, imágenes de referencia o fotogramas inicial y final. Guarde el valor id devuelto para consultar la tarea y descargar el vídeo completado. POST /v1/videos usa multipart/form-data. Envíe los controles como campos de formulario. Para las entradas de imagen, use URL de imágenes de referencia o fotogramas inicial y final. Mantenga input_reference separado de first_frame y last_frame.

Elija un modo de entrada

Objetivo	Campos obligatorios	Campos opcionales
Texto a vídeo	`model=flux-3`, `prompt`	`seconds`, `size`
Imagen a vídeo mediante HTTPS	`model=flux-3`, `prompt`, una URL de `input_reference`	`seconds`, `size`
Fotogramas clave ordenados	`model=flux-3`, `prompt`, URL de `input_reference` repetidas	`seconds`, `size`
Fotograma inicial cargado	`model=flux-3`, `prompt`, un archivo `first_frame`	`seconds`, `size`
Vídeo con fotograma inicial y final	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Usar imágenes de referencia

El campo input_reference solo acepta URL de imágenes HTTPS accesibles públicamente. Envíelo una vez para una sola imagen o repítalo en el orden de los fotogramas clave para varias imágenes. Use una URL por campo, con un máximo de 10 URL en total. Describa el movimiento, el comportamiento de la cámara y los detalles visuales que el vídeo generado debe conservar de la imagen de referencia. Los ejemplos de solicitudes en la parte superior de esta página muestran entradas de una sola imagen y de varias imágenes. La siguiente solicitud usa dos imágenes en el orden en que se enviaron:

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'

Establecer los fotogramas inicial y final

Envíe first_frame para establecer la imagen inicial. Para establecer también la imagen final, incluya last_frame y describa el movimiento entre los dos fotogramas en prompt. Para un fotograma inicial únicamente, omita last_frame. Un fotograma final requiere tanto first_frame como last_frame. Cada campo acepta una URL HTTPS accesible públicamente o un archivo PNG o JPEG. Envíe cada campo una vez, mediante una URL o un archivo. Mantenga cada archivo en 20 MiB o menos (20 × 1024 × 1024 bytes). Los ejemplos de fotogramas en la parte superior de esta página muestran entradas de URL y cargas de archivos, con seconds y size establecidos explícitamente.

Establecer la duración y el tamaño

Establezca seconds explícitamente en un número entero de 5 a 20. Establezca size en uno de estos valores preestablecidos exactos de WxH:

Nivel de resolución	Tamaño
`720p`	`1280x720`
`1080p`	`1920x1080`

El valor de tamaño selecciona el nivel de resolución de salida. Para texto a vídeo, las dimensiones codificadas se pueden ajustar para la alineación del códec. Para imagen a vídeo, la imagen de referencia también puede determinar el encuadre final y la relación de aspecto.

Flujo de la tarea

Crear la tarea

Envíe la solicitud de formulario multipart y guarde el valor id devuelto.

Consultar la tarea

Llame a Recuperar un vídeo de Flux 3 hasta que status sea completed o failed.

Descargar el resultado

Cuando la tarea esté completed, llame a Descargar contenido de vídeo de Flux 3 para guardar el archivo MP4.

Autorizaciones

Authorization

string

header

requerido

Bearer authentication. Use your CometAPI API key.

Cuerpo

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

predeterminado:flux-3

requerido

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

predeterminado:A paper boat glides across a still pond while the camera moves forward.

requerido

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.

Rango requerido: 5 <= x <= 20

size

enum<string>

predeterminado: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.

Opciones disponibles:

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://

Respuesta

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

string

requerido

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

Ejemplo:

"<task_id>"

object

string

requerido

Object type for the asynchronous video task.

Allowed value: "video"

model

string

requerido

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

requerido

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

Opciones disponibles:

queued,

in_progress,

completed,

failed

progress

integer

requerido

Task progress as a coarse percentage.

Rango requerido: 0 <= x <= 100

created_at

integer<int64>

requerido

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Ejemplo:

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

Ejemplo:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

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

Moderación de contenido

Claves API

Elija un modo de entrada

Usar imágenes de referencia

Establecer los fotogramas inicial y final

Establecer la duración y el tamaño

Flujo de la tarea

Autorizaciones

Cuerpo

Respuesta

​Elija un modo de entrada

​Usar imágenes de referencia

​Establecer los fotogramas inicial y final

​Establecer la duración y el tamaño

​Flujo de la tarea

Autorizaciones

Cuerpo

Respuesta

Elija un modo de entrada

Usar imágenes de referencia

Establecer los fotogramas inicial y final

Establecer la duración y el tamaño

Flujo de la tarea