Chuyển đến nội dung chính
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.

Sử dụng trang này để khởi tạo một tác vụ Veo thông qua route dùng chung CometAPI /v1/videos. Hãy chọn một alias Veo hiện hành từ trang Models khi thiết lập model.

​
Chọn mẫu request

  • Text-to-video: không gửi tệp input_reference
  • Image-to-video: gửi một input_reference
  • Hướng dẫn first-frame và last-frame: gửi hai tệp input_reference theo đúng thứ tự

​
Luồng tác vụ

1

Gửi tác vụ Veo

Gửi một alias Veo, prompt và các đầu vào hình ảnh tùy chọn, sau đó lưu id được trả về.
2

Thăm dò endpoint video dùng chung

Sử dụng Veo3 Retrieve để theo dõi tác vụ bất đồng bộ cho đến khi nó đạt trạng thái kết thúc.
3

Lưu trữ kết quả

Chuyển asset đã hoàn tất vào hệ thống lưu trữ của riêng bạn nếu ứng dụng của bạn cần một bản sao bền vững.

​
Phân giải alias

Trường model trong response có thể hiển thị id model backend đã được phân giải thay vì alias bạn đã gửi. Sử dụng trang Models để tìm các alias Veo hiện hành.

Ủy quyền

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Nội dung

multipart/form-data
​
prompt
string
bắt buộc

Text prompt for the video job.

Ví dụ:

"A paper kite floats above a field."

​
model
string
mặc định: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.

Ví dụ:

"veo3-fast"

​
size
string

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

Ví dụ:

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

Phản hồi

200 - application/json

Task accepted.

​
created_at
integer
bắt buộc
​
id
string
bắt buộc
​
model
string
bắt buộc

Provider model identifier resolved by CometAPI for this task.

​
object
string
bắt buộc
​
progress
integer
bắt buộc
​
seconds
string
bắt buộc
​
size
string
bắt buộc
​
status
string
bắt buộc