Перейти к основному содержанию
POST
/
v1
/
videos
Create a Veo video job
curl --request POST \
  --url https://api.cometapi.com/v1/videos \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: multipart/form-data' \
  --form 'prompt=A paper kite floats above a field.' \
  --form input_reference='@example-file'
{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

Используйте эту страницу, чтобы запустить задачу Veo через общий маршрут CometAPI /v1/videos. При указании model выберите актуальный alias Veo на странице Models page.

​
Выберите шаблон запроса

  • Text-to-video: не отправляйте файлы input_reference
  • Image-to-video: отправьте один input_reference
  • First-frame and last-frame guidance: отправьте два упорядоченных файла input_reference

​
Поток задачи

1

Отправьте задачу Veo

Передайте alias Veo, prompt и при необходимости входные изображения, затем сохраните возвращённый id.
2

Опрашивайте общий video endpoint

Используйте Veo3 Retrieve, чтобы отслеживать асинхронную задачу, пока она не достигнет конечного состояния.
3

Сохраните результат

Переместите готовый asset в собственное хранилище, если вашему приложению нужна постоянная копия.

​
Разрешение alias

Поле model в ответе может содержать разрешённый backend model id, а не alias, который вы отправили. Используйте страницу Models page, чтобы найти актуальные alias Veo.

Авторизации

​
Authorization
string
header
обязательно

Bearer token authentication. Use your CometAPI key.

Тело

multipart/form-data
​
prompt
string
обязательно

Text prompt for the video job.

Пример:

"A paper kite floats above a field."

​
model
string
по умолчанию:veo3-fast

CometAPI Veo alias. Use a current Veo alias from the Models page. The response may resolve this alias to a provider model id.

Пример:

"veo3-fast"

​
size
string

Orientation hint. Use a landscape-like value such as 16x9 or a portrait-like value such as 9x16.

Пример:

"16x9"

​
input_reference
file

Optional image input. Send one file for image-to-video or two ordered files for first-frame and last-frame guidance.

Ответ

200 - application/json

Task accepted.

​
created_at
integer
обязательно
​
id
string
обязательно
​
model
string
обязательно

Provider model identifier resolved by CometAPI for this task.

​
object
string
обязательно
​
progress
integer
обязательно
​
seconds
string
обязательно
​
size
string
обязательно
​
status
string
обязательно