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
Truy xuất Video
Sử dụng CometAPI GET /v1/videos/ để truy xuất trạng thái, tiến độ và metadata của video Sora 2 như thời lượng, kích thước, dấu thời gian và thời điểm hết hạn.
GET
/
v1
/
videos
/
{video_id}
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}Sử dụng endpoint này sau khi bạn bắt đầu một job Sora. Endpoint này báo cáo trạng thái hiện tại của job, kích thước và thời lượng đã cấu hình, cùng với mọi lỗi do nhà cung cấp trả về.
Theo dõi các trường này
statuscho trạng thái vòng đờiprogresscho tín hiệu tiến độ ở mức tổng quáterrorkhi nhà cung cấp từ chối hoặc job bị lỗiexpires_atsau khi hoàn tất nếu bạn cần biết khi nào các tài nguyên tạm thời hết hạn
Poll cho đến khi hoàn tất
Tạo hoặc remix video trước
Bắt đầu với Create Video hoặc Remix Video.
Poll theo id
Truyền
id được trả về vào đây và tiếp tục kiểm tra cho đến khi job đạt completed hoặc failed.Tải tệp xuống
Khi job ở trạng thái
completed, chuyển sang Retrieve Video Content.Cấu trúc phản hồi trên CometAPI
Bước này bám rất sát quy trình polling của Sora. CometAPI giữ nguyên cấu trúc object kiểu OpenAI để bạn có thể nối phần kiểm tra trạng thái với mức chuyển đổi tối thiểu.Ủy quyền
Bearer token authentication. Use your CometAPI key.
Tham số đường dẫn
Video id returned by the create or remix endpoint.
Phản hồi
200 - application/json
Current job state.
⌘I
Retrieve a Sora video job
curl --request GET \
--url https://api.cometapi.com/v1/videos/{video_id} \
--header 'Authorization: Bearer <token>'{
"id": "video_69b25d5f467c81908733a56bc236b4df",
"size": "1280x720",
"error": null,
"model": "sora-2",
"object": "video",
"prompt": "A paper airplane glides across a desk.",
"status": "in_progress",
"seconds": "4",
"progress": 0,
"created_at": 1773296991,
"expires_at": null,
"completed_at": null,
"remixed_from_video_id": null
}