Tạo video Omni từ văn bản, hình ảnh hoặc video

POST

videos

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Sử dụng endpoint beta này để tạo tác vụ chuyển văn bản thành video, chuyển hình ảnh thành video hoặc chuyển video thành video. API trả về ngay một ID tác vụ, vì vậy hãy lưu id được trả về và thăm dò tác vụ cho đến khi tác vụ đạt trạng thái cuối. Chọn kiểu nội dung yêu cầu phù hợp với chế độ đầu vào. Gửi các tùy chọn điều khiển chuyển văn bản thành video và chuyển hình ảnh thành video dưới dạng các trường multipart/form-data. Gửi nội dung chỉnh sửa video tham chiếu dưới dạng body application/json.

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

Mục tiêu	Kiểu nội dung	Các trường bắt buộc	Các trường tùy chọn
Văn bản sang video	`multipart/form-data`	`model`, `prompt`	`seconds`, `aspect_ratio`, `resolution`
Hình ảnh sang video	`multipart/form-data`	`model`, `prompt`, `input_reference`	`seconds`, `aspect_ratio`, `resolution`
Video sang video	`application/json`	`model`, `prompt`, `video`	`seconds`, `aspect_ratio`, `resolution`

Các ví dụ chuyển văn bản thành video và chuyển hình ảnh thành video sử dụng model=omni-fast. Các ví dụ chuyển video thành video sử dụng model=omni-fast-v2v. Hãy sử dụng Liệt kê các model có sẵn để xác nhận rằng ID model hiển thị cho API key của bạn.

Tạo chuyển động cho hình ảnh tham chiếu

Đối với chuyển hình ảnh thành video, hãy sử dụng model=omni-fast và tải lên một tệp PNG trong trường multipart input_reference. Trường này vẫn là tùy chọn đối với chuyển văn bản thành video, nhưng bắt buộc khi hình ảnh tham chiếu cần định hướng video được tạo. Tập trung prompt vào chuyển động cần thêm và nêu rõ màu sắc, hình dạng, chủ thể hoặc bố cục mà kết quả cần giữ nguyên. Bộ chọn mẫu mã bao gồm các ví dụ Shell, Python và JavaScript tải reference.png từ thư mục làm việc lên và tạo tác vụ. Dạng yêu cầu này áp dụng cho một tệp PNG được tải lên. Dạng này không xác định đầu vào URL, các định dạng hình ảnh khác, nhiều hình ảnh tham chiếu hoặc giới hạn kích thước tệp.

Chỉnh sửa video tham chiếu

Đối với chuyển video thành video, hãy mã hóa một tệp MP4 cục bộ dưới dạng base64 và thêm tiền tố data:video/mp4;base64, vào các byte đã mã hóa. Gửi data URL hoàn chỉnh trong trường video. Mô tả các thay đổi được yêu cầu trong prompt. Đồng thời nêu rõ chủ thể, đối tượng, bố cục hoặc chuyển động mà kết quả cần giữ nguyên. Bộ chọn mẫu mã bao gồm các ví dụ Shell, Python và JavaScript đọc reference.mp4 từ thư mục làm việc. Dạng yêu cầu này áp dụng cho một data URL MP4 nội tuyến. Dạng này không xác định đầu vào URL, các định dạng vùng chứa video khác hoặc giới hạn kích thước tệp.

Thiết lập thời lượng, tỷ lệ và độ phân giải

Omni được đánh dấu beta vì độ ổn định khi tạo có thể thay đổi tùy theo đầu vào và route đã chọn. Hãy giữ yêu cầu đầu tiên ở quy mô nhỏ, sau đó kiểm tra video đã hoàn tất trước khi dựa vào một thời lượng kết xuất hoặc kích thước khung hình cụ thể.

Thiết lập	Giá trị được hỗ trợ	Mặc định	Hành vi tại ranh giới
`seconds`	Bắt đầu với `4`	Phụ thuộc vào route	Hãy coi đây là thời lượng được yêu cầu và xác minh MP4 đã hoàn tất vì thời lượng đầu ra có thể khác.
`aspect_ratio`	`16:9`, `9:16`, `1:1`	`16:9`	`9:16` có thể kết xuất đầu ra dọc. `1:1` có thể được chấp nhận trong khi kết xuất ở chế độ ngang.
`resolution`	Bắt đầu với `720p`; `1080p` có thể được chấp nhận	`720p`	Đầu ra production hiện tại có thể chuẩn hóa thành `720p` ngay cả khi `1080p` được yêu cầu.

Yêu cầu	Khung hình hoàn tất quan sát được
`resolution=720p`, `aspect_ratio=16:9`	`1280x720`
`resolution=720p`, `aspect_ratio=9:16`	`720x1280`
`resolution=720p`, `aspect_ratio=1:1`	`1280x720`
`resolution=1080p`, `aspect_ratio=16:9`	`1280x720`

Vì endpoint này là beta, hãy coi aspect_ratio và resolution là các tùy chọn ưu tiên khi tạo, đồng thời xác minh MP4 đã tải xuống trước khi phụ thuộc vào pixel cuối cùng.

Luồng tác vụ

Tạo tác vụ

Gửi yêu cầu với content type cho chế độ đầu vào đã chọn và lưu id được trả về.

Thăm dò tác vụ

Gọi Truy xuất video Omni cho đến khi status là completed hoặc failed.

Tải xuống kết quả

Khi tác vụ có trạng thái completed, hãy gọi Truy xuất nội dung video Omni để tải xuống tệp MP4.

Ủy quyền

Authorization

string

header

bắt buộc

Bearer authentication. Use your CometAPI API key.

Nội dung

model

string

bắt buộc

Omni model ID for this endpoint. Use omni-fast for text-to-video and image-to-video.

Ví dụ:

"omni-fast"

prompt

string

bắt buộc

Text prompt that describes the video to generate. For image-to-video, focus on motion and name the reference content that should be preserved.

Ví dụ:

"Ocean waves rolling onto a sandy beach at golden hour"

input_reference

file

One PNG reference image uploaded as a multipart file. Optional for text-to-video and required for image-to-video. This contract does not define URL input, other image formats, multiple references, or a file-size limit.

seconds

string

Requested clip duration in seconds. The completed video can use a different duration.

Ví dụ:

"4"

aspect_ratio

enum<string>

mặc định:16:9

Output aspect ratio preference. 16:9 and 9:16 are the most predictable; 1:1 can be accepted but may render as landscape.

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

16:9,

9:16,

1:1

Ví dụ:

"16:9"

resolution

string

Output resolution preference. Start with 720p. A request for 1080p can render at 720p.

Ví dụ:

"720p"

Phản hồi

200 - application/json

Task accepted. 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ụ:

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

Show child attributes

Lần sửa đổi cuối 4 tháng 8, 2026

curl https://api.cometapi.com/v1/videos \
  -H "Authorization: Bearer $COMETAPI_KEY" \
  -F model=omni-fast \
  -F 'prompt=Ocean waves rolling onto a sandy beach at golden hour' \
  -F seconds=4 \
  -F aspect_ratio=16:9 \
  -F resolution=720p

{
  "id": "task_example",
  "task_id": "task_example",
  "object": "video",
  "model": "omni-fast",
  "status": "queued",
  "progress": 0,
  "created_at": 1779938152
}

Kiểm duyệt nội dung

Khóa API

Tạo video Omni từ văn bản, hình ảnh hoặc video

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

Tạo chuyển động cho hình ảnh tham chiếu

Chỉnh sửa video tham chiếu

Thiết lập thời lượng, tỷ lệ và độ phân giải

Luồng tác vụ

Ủy quyền

Nội dung

Phản hồi

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

​Tạo chuyển động cho hình ảnh tham chiếu

​Chỉnh sửa video tham chiếu

​Thiết lập thời lượng, tỷ lệ và độ phân giải

​Luồng tác vụ

Ủy quyền

Nội dung

Phản hồi

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

Tạo chuyển động cho hình ảnh tham chiếu

Chỉnh sửa video tham chiếu

Thiết lập thời lượng, tỷ lệ và độ phân giải

Luồng tác vụ