Skip to main content
GET
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 video trước

Bắt đầu với Create 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 trạng thái completed hoặc failed.
3

Tải xuống tệp

Khi job ở trạng thái completed, chuyển sang Retrieve Video Content.

​
Hình dạng phản hồi trên CometAPI

Bước này bám sát quy trình polling của Sora. CometAPI giữ nguyên hình dạng object kiểu OpenAI để bạn có thể kết nối các bước 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

Task id.

​
size
string
bắt buộc
​
model
string
bắt buộc
​
object
string
bắt buộc
​
status
string
bắt buộc

Task state: queued, in_progress, completed, or failed.

​
seconds
string
bắt buộc
​
progress
integer
bắt buộc

Render progress from 0 to 100.

​
created_at
integer
bắt buộc

Unix timestamp of task creation.

​
error
object | null
​
prompt
string
​
expires_at
integer | null
​
completed_at
integer | null

Unix timestamp of completion.

​
remixed_from_video_id
string | null
​
video_url
string

Time-limited download URL present when status is completed. Mirror the file to your own storage for long retention.