Tạo video 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
}

Tạo video Veo 3.1 từ văn bản hoặc hình ảnh. API trả về ID tác vụ ngay lập tức. Lưu id được trả về để thăm dò tác vụ và tải xuống video đã hoàn tất. POST /v1/videos sử dụng multipart/form-data. Gửi các tùy chọn điều khiển dưới dạng trường biểu mẫu và một hình ảnh dưới dạng trường tệp input_reference.

Chọn một model

ID model	Khi nào sử dụng	Ghi chú
`veo3.1-fast`	Lựa chọn mặc định cho hầu hết các clip ngắn	Tuyến Veo 3.1 nhanh hơn.
`veo3.1`	Dùng khi bạn đặc biệt muốn model Veo 3.1 tiêu chuẩn	Tuyến Veo 3.1 tiêu chuẩn.

Chọn chế độ đầu vào

Mục tiêu	Trường bắt buộc	Trường không bắt buộc
Văn bản sang video	`model`, `prompt`	`seconds`, `size`
Hình ảnh sang video	`model`, `prompt`, một tệp hình ảnh `input_reference`	`seconds`, `size`

Để tạo hiệu ứng chuyển động cho một hình ảnh, hãy tải lên một tệp qua input_reference, sử dụng trường này một lần. Hình ảnh đặt khung hình mở đầu; prompt mô tả chuyển động và hành vi camera tiếp theo.

Đặt thời lượng và kích thước

Đối với tuyến tương thích OpenAI này, hãy đặt thời lượng bằng giá trị số nguyên seconds rõ ràng và kích thước đầu ra bằng size. Gửi cả hai giá trị dưới dạng trường biểu mẫu.

ID model	`seconds`	Mặc định
`veo3.1-fast`	`4`, `6`, `8`	`4` giây, `1280x720`
`veo3.1`	`4`, `6`, `8`	`4` giây, `1280x720`

Đặt size thành một trong các giá trị WxH bên dưới.

Cấp độ độ phân giải	Tỷ lệ khung hình	`size` (`WxH`)
`720p`	`16:9`	`1280x720`
	`9:16`	`720x1280`
`1080p`	`16:9`	`1920x1080`
`4K`	`16:9`	`3840x2160`

Luồng tác vụ

Tạo tác vụ

Gửi yêu cầu biểu mẫu multipart và lưu id được trả về.

Thăm dò tác vụ

Sử dụng Veo3 Retrieve cho đến khi status là completed, failed hoặc error.

Tải kết quả xuống

Khi tác vụ ở trạng thái completed, hãy tải tệp MP4 xuống từ phản hồi tác vụ đã hoàn tất.

Ủy quyền

Authorization

string

header

bắt buộc

Bearer authentication. Use your CometAPI API key.

Nội dung

multipart/form-data

model

enum<string>

bắt buộc

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

Tùy chọn có sẵn:

veo3.1-fast,

veo3.1

Ví dụ:

"veo3.1-fast"

prompt

string

bắt buộc

Text prompt for the video job.

Ví dụ:

"A paper kite floats above a field."

seconds

enum<integer>

mặc định:4

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

Tùy chọn có sẵn:

4,

6,

8

Ví dụ:

4

size

string

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

Ví dụ:

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

Phản hồi

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

string

bắt buộc

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

Ví dụ:

"task_example"

object

string

bắt buộc

Object type. Video tasks return video.

Ví dụ:

"video"

model

string

bắt buộc

Model ID used for the task.

Ví dụ:

"veo3.1-fast"

status

enum<string>

bắt buộc

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

Tùy chọn có sẵn:

queued,

in_progress,

completed,

failed,

error

Ví dụ:

"queued"

progress

integer

bắt buộc

Task progress as a coarse percentage.

Phạm vi bắt buộc: 0 <= x <= 100

Ví dụ:

0

created_at

integer

bắt buộc

Task creation time as a Unix timestamp in seconds.

Ví dụ:

1779938152

task_id

string

Compatibility alias for id when present.

Ví dụ:

"task_example"

completed_at

integer

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

Ví dụ:

1779938219

video_url

string

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

Ví dụ:

"<temporary-video-url>"

error

object

Failure details. This field appears when the task fails.

Lần sửa đổi cuối 9 tháng 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
}

Kiểm duyệt nội dung

Khóa API

Chọn một model

Chọn chế độ đầu vào

Đặt thời lượng và kích thước

Luồng tác vụ

Ủy quyền

Nội dung

Phản hồi

​Chọn một model

​Chọn chế độ đầu vào

​Đặt thời lượng và kích thước

​Luồng tác vụ

Ủy quyền

Nội dung

Phản hồi

Chọn một model

Chọn chế độ đầu vào

Đặt thời lượng và kích thước

Luồng tác vụ