Перейти до основного вмісту
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. Виберіть актуальний псевдонім Veo на сторінці Models під час налаштування model.

​
Виберіть шаблон запиту

  • Text-to-video: не надсилайте файли input_reference
  • Image-to-video: надішліть один input_reference
  • Керування першим і останнім кадром: надішліть два впорядковані файли input_reference

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

1

Надішліть завдання Veo

Надішліть псевдонім Veo, prompt і необов’язкові вхідні зображення, а потім збережіть повернений id.
2

Опитуйте спільний endpoint відео

Використовуйте Veo3 Retrieve, щоб відстежувати асинхронне завдання, доки воно не досягне кінцевого стану.
3

Збережіть результат

Перемістіть готовий asset до власного сховища, якщо вашому застосунку потрібна довготривала копія.

​
Визначення псевдоніма

Поле model у відповіді може показувати визначений id бекенд-моделі, а не псевдонім, який ви надіслали. Використовуйте сторінку Models, щоб знайти актуальні псевдоніми 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
обов'язково