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

Створіть відео Veo 3.1 із тексту або зображення. API негайно повертає ідентифікатор завдання. Збережіть повернений id, щоб опитувати завдання та завантажити готове відео. POST /v1/videos використовує multipart/form-data. Надсилайте параметри керування як поля форми, а зображення — як поле файлу input_reference.

Виберіть модель

Ідентифікатор моделі	Коли її використовувати	Примітки
`veo3.1-fast`	Типовий вибір для більшості коротких кліпів	Швидший маршрут Veo 3.1.
`veo3.1`	Використовуйте, якщо вам потрібна саме стандартна модель Veo 3.1	Стандартний маршрут Veo 3.1.

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

Мета	Обов’язкові поля	Необов’язкові поля
Текст у відео	`model`, `prompt`	`seconds`, `size`
Зображення у відео	`model`, `prompt`, один `input_reference` файл зображення	`seconds`, `size`

Щоб анімувати зображення, завантажте один файл через input_reference, використовуючи поле один раз. Зображення задає початковий кадр; prompt описує подальший рух і поведінку камери.

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

Для цього OpenAI-сумісного маршруту встановіть тривалість за допомогою явного цілого значення seconds, а розмір виводу — за допомогою size. Надсилайте обидва значення як поля форми.

Ідентифікатор моделі	`seconds`	За замовчуванням
`veo3.1-fast`	`4`, `6`, `8`	`4` секунд, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` секунд, `1280x720`

Установіть size на одне зі значень WxH нижче.

Рівень роздільної здатності	Співвідношення сторін	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

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

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

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

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

Використовуйте Veo3 Retrieve доки status не стане completed, failed або error.

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

Коли завдання має стан completed, завантажте файл MP4 із відповіді про завершене завдання.

Авторизації

Authorization

string

header

обов'язково

Bearer authentication. Use your CometAPI API key.

Тіло

multipart/form-data

model

enum<string>

обов'язково

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

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

veo3.1-fast,

veo3.1

Приклад:

"veo3.1-fast"

prompt

string

обов'язково

Text prompt for the video job.

Приклад:

"A paper kite floats above a field."

seconds

enum<integer>

за замовчуванням:4

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

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

4,

6,

8

Приклад:

4

size

string

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

Приклад:

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

Відповідь

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

string

обов'язково

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

Приклад:

"task_example"

object

string

обов'язково

Object type. Video tasks return video.

Приклад:

"video"

model

string

обов'язково

Model ID used for the task.

Приклад:

"veo3.1-fast"

status

enum<string>

обов'язково

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

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

queued,

in_progress,

completed,

failed,

error

Приклад:

"queued"

progress

integer

обов'язково

Task progress as a coarse percentage.

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

Приклад:

0

created_at

integer

обов'язково

Task creation time as a Unix timestamp in seconds.

Приклад:

1779938152

task_id

string

Compatibility alias for id when present.

Приклад:

"task_example"

completed_at

integer

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

Приклад:

1779938219

video_url

string

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

Приклад:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

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

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

API-ключі

Виберіть модель

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

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

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

Авторизації

Тіло

Відповідь

​Виберіть модель

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

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

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

Авторизації

Тіло

Відповідь

Виберіть модель

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

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

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