Створення відео 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
}

Створіть відео Flux 3 із тексту, референсних зображень або першого й останнього кадрів. Збережіть повернений id, щоб опитувати завдання та завантажити готове відео. POST /v1/videos використовує multipart/form-data. Надсилайте параметри керування як поля форми. Для вхідних зображень використовуйте URL-адреси референсних зображень або початковий і кінцевий кадри. Зберігайте input_reference окремо від first_frame і last_frame.

Виберіть режим введення

Мета	Обов’язкові поля	Необов’язкові поля
Текст у відео	`model=flux-3`, `prompt`	`seconds`, `size`
Відео з HTTPS-зображення	`model=flux-3`, `prompt`, одна URL-адреса `input_reference`	`seconds`, `size`
Впорядковані ключові кадри	`model=flux-3`, `prompt`, повторювані URL-адреси `input_reference`	`seconds`, `size`
Завантажений початковий кадр	`model=flux-3`, `prompt`, один файл `first_frame`	`seconds`, `size`
Відео з першого й останнього кадрів	`model=flux-3`, `prompt`, `first_frame`, `last_frame`	`seconds`, `size`

Використання референсних зображень

Поле input_reference приймає лише загальнодоступні HTTPS URL-адреси зображень. Надішліть його один раз для одного зображення або повторіть у порядку ключових кадрів для кількох зображень. Використовуйте одну URL-адресу на поле, загалом до 10 URL-адрес. Опишіть рух, поведінку камери та візуальні деталі, які згенероване відео має зберегти з референсного зображення. Зразки запитів у верхній частині цієї сторінки показують введення одного та кількох зображень. У наведеному нижче запиті використовуються два зображення в порядку їх надсилання:

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'

Установіть перший і останній кадри

Надішліть first_frame, щоб установити початкове зображення. Щоб також установити кінцеве зображення, додайте last_frame і опишіть рух між двома кадрами в prompt. Лише для початкового кадру не вказуйте last_frame. Для кінцевого кадру потрібні як first_frame, так і last_frame. Кожне поле приймає одну загальнодоступну HTTPS URL-адресу або один файл PNG чи JPEG. Надсилайте кожне поле один раз, використовуючи URL-адресу або файл. Розмір кожного файлу має бути не більшим за 20 MiB (20 × 1024 × 1024 байтів). Приклади кадрів у верхній частині цієї сторінки показують URL-введення та завантаження файлів із явно встановленими seconds і size.

Установіть тривалість і розмір

Явно встановіть seconds як ціле число від 5 до 20. Установіть для size одне з цих точних значень пресету WxH:

Рівень роздільності	Розмір
`720p`	`1280x720`
`1080p`	`1920x1080`

Значення розміру визначає рівень роздільності вихідного відео. Для режиму текст у відео закодовані розміри можуть бути скориговані для вирівнювання кодека. Для режиму зображення у відео референсне зображення також може визначати остаточне кадрування та співвідношення сторін.

Потік завдання

Створіть завдання

Надішліть запит multipart form і збережіть повернений id.

Опитуйте завдання

Викликайте Отримання відео Flux 3 доки status не матиме значення completed або failed.

Завантажте результат

Коли завдання має стан completed, викличте Завантаження відеовмісту Flux 3 щоб зберегти файл MP4.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

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

за замовчуванням:flux-3

обов'язково

Model ID for this route. Use flux-3.

Allowed value: "flux-3"

prompt

string

за замовчуванням:A paper boat glides across a still pond while the camera moves forward.

обов'язково

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.

Необхідний діапазон: 5 <= x <= 20

size

enum<string>

за замовчуванням: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.

Доступні опції:

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

Відповідь

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

string

обов'язково

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

Приклад:

"<task_id>"

object

string

обов'язково

Object type for the asynchronous video task.

Allowed value: "video"

model

string

обов'язково

Model ID that the task uses.

Allowed value: "flux-3"

status

enum<string>

обов'язково

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

Доступні опції:

queued,

in_progress,

completed,

failed

progress

integer

обов'язково

Task progress as a coarse percentage.

Необхідний діапазон: 0 <= x <= 100

created_at

integer<int64>

обов'язково

Task creation time as a Unix timestamp in seconds.

task_id

string

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

Приклад:

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

Приклад:

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

error

object

Failure details. This field appears when the task fails.

Show child attributes

Останнє оновлення 9 вересня 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
}

Модерація контенту

API-ключі

Виберіть режим введення

Використання референсних зображень

Установіть перший і останній кадри

Установіть тривалість і розмір

Потік завдання

Авторизації

Тіло

Відповідь

​Виберіть режим введення

​Використання референсних зображень

​Установіть перший і останній кадри

​Установіть тривалість і розмір

​Потік завдання

Авторизації

Тіло

Відповідь

Виберіть режим введення

Використання референсних зображень

Установіть перший і останній кадри

Установіть тривалість і розмір

Потік завдання