Skip to main content
POST
Sử dụng endpoint này để bắt đầu một tác vụ render Sora từ văn bản, hoặc từ văn bản cộng với một hình ảnh tham chiếu. API trả về một video id ngay lập tức và không chờ quá trình render hoàn tất.

​
Bắt đầu với tác vụ nhỏ nhất hữu ích

  • Dùng sora-2 để lặp nhanh hơn hoặc sora-2-pro khi chất lượng đầu ra quan trọng hơn tốc độ
  • Giữ seconds ở 4 cho yêu cầu đầu tiên của bạn
  • Bắt đầu với size: 1280x720 trừ khi bạn thực sự cần đầu ra dọc
  • Tải lên nhiều nhất một hình ảnh tham chiếu

​
Thời lượng và kích thước

Sora yêu cầu trường size ở đúng định dạng WxH. Các token độ phân giải như 720p và nhãn tỷ lệ như 16:9 không phải là giá trị size hợp lệ của Sora trên endpoint này.

​
Quy trình end-to-end

1

Tạo tác vụ render

Gửi model, prompt, seconds, và size, sau đó lưu id được trả về.
2

Thăm dò cho đến khi tác vụ hoàn tất

Gọi Retrieve Video cho đến khi trạng thái trở thành completed hoặc failed.
3

Tải xuống kết quả

Khi quá trình render hoàn tất, lấy tệp bằng Retrieve Video Content.

​
Hành vi của Sora vẫn áp dụng

OpenAI mô tả cùng một quy trình create -> retrieve -> download trong Videos API. Trên CometAPI, bạn giữ nguyên định dạng yêu cầu của Sora, nhưng sử dụng base URL và key của CometAPI. Các URL tải xuống đã hoàn tất là tạm thời, vì vậy hãy sao chép các tài nguyên đã hoàn tất vào bộ nhớ lưu trữ của riêng bạn nếu bạn cần lưu giữ lâu dài.

Ủ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 that describes the video you want to create.

Ví dụ:

"A paper airplane glides across a desk."

​
model
string
mặc định:sora-2

Sora model ID. Choose an available model from the Models page.

Ví dụ:

"sora-2"

​
seconds
enum<string>
mặc định:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Tùy chọn có sẵn:
4,
8,
12,
16,
20
Ví dụ:

"4"

​
size
enum<string>
mặc định:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Tùy chọn có sẵn:
720x1280,
1280x720,
1024x1792,
1792x1024
Ví dụ:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Phản hồi

200 - application/json

Video job accepted.

​
created_at
integer
bắt buộc
​
id
string
bắt buộc
​
model
string
bắt buộc
​
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