Chuyển đến nội dung chính
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

  • status cho trạng thái vòng đời
  • progress cho tín hiệu tiến độ ở mức tổng quát
  • error khi nhà cung cấp từ chối hoặc job bị lỗi
  • expires_at sau 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

1

Tạo hoặc remix video trước

Bắt đầu với Create Video hoặc Remix Video.
2

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

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

​
Authorization
string
header
bắt buộc

Bearer token authentication. Use your CometAPI key.

Tham số đường dẫn

​
video_id
string
bắt buộc

Video id returned by the create or remix endpoint.

Phản hồi

200 - application/json

Current job state.

​
id
string
bắt buộc
​
size
string
bắt buộc
​
model
string
bắt buộc
​
object
string
bắt buộc
​
status
string
bắt buộc
​
seconds
string
bắt buộc
​
progress
integer
bắt buộc
​
created_at
integer
bắt buộc
​
error
object
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null
​
remixed_from_video_id
string | null