Tài liệu tham khảo API
Hướng dẫn tích hợp
Giá & Thanh toán
API chính thức
Tạo Video
Sử dụng POST /v1/videos để tạo tác vụ sinh video Sora 2 từ prompt văn bản hoặc hình ảnh tham chiếu, sau đó truy vấn trạng thái theo ID tác vụ để lấy kết quả.
POST
/
v1
/
videos
Create a Sora 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 airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}Sử dụng endpoint này để bắt đầu một tác vụ render Sora mới từ văn bản, hoặc từ văn bản kèm một hình ảnh tham chiếu. API trả về một video id ngay lập tức và không chờ render hoàn tất.
Bắt đầu với tác vụ nhỏ nhất nhưng hữu ích
- Dùng
sora-2để lặp thử nhanh hơn hoặcsora-2-prokhi chất lượng đầu ra quan trọng hơn tốc độ - Giữ
secondsở4cho yêu cầu đầu tiên của bạn - Bắt đầu với
size: 1280x720trừ khi bạn thực sự cần đầu ra theo chiều dọc - Chỉ tải lên tối đa một hình ảnh tham chiếu
Luồng end-to-end
Truy vấn cho đến khi tác vụ hoàn tất
Gọi Truy xuất Video cho đến khi trạng thái chuyển thành
completed hoặc failed.Tải xuống hoặc remix kết quả
Khi render hoàn tất, lấy tệp bằng Truy xuất Nội dung Video. Nếu bạn muốn một biến thể có điều chỉnh mục tiêu, hãy dùng Remix Video trên kết quả đã hoàn tất.
Hành vi của Sora vẫn áp dụng
OpenAI mô tả cùng luồng tạo -> truy xuất -> tải xuống trong Videos API. Trên CometAPI, bạn vẫn giữ nguyên cấu trúc request của Sora, nhưng sử dụng base URL và key của CometAPI. Các URL tải xuống sau khi hoàn tất chỉ có hiệu lực tạm thời, vì vậy hãy sao chép các tài nguyên đã hoàn tất vào hệ thống 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
Bearer token authentication. Use your CometAPI key.
Nội dung
multipart/form-data
Text prompt that describes the video you want to create.
Ví dụ:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Ví dụ:
"sora-2"
Clip duration in seconds.
Tùy chọn có sẵn:
4, 8, 12 Ví dụ:
"4"
Output resolution formatted as width x height.
Tùy chọn có sẵn:
720x1280, 1280x720, 1024x1792, 1792x1024 Ví dụ:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora 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 airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}