Tạo Video Bất Đồng Bộ

Tạo video Veo3 bất đồng bộ thông qua POST /v1/videos trong CometAPI, trả về task id và hỗ trợ hướng dẫn first/last-frame cho các clip 8 giây.

POST /v1/videos

Create a Veo video job

cURL

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'

200

{
  "created_at": 1773297229,
  "id": "task_pa9CKKtYlTdxO7IIHOKKhXfjxEu4EQoR",
  "model": "veo_3_1-4K",
  "object": "video",
  "progress": 0,
  "seconds": "",
  "size": "16x9",
  "status": "queued"
}

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 used by the wrapper. 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