Ana içeriğe atla
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
}
Bir Sora işi başlattıktan sonra bu endpoint’i kullanın. Geçerli iş durumunu, yapılandırılmış boyut ve süreyi ve sağlayıcı tarafından döndürülen herhangi bir hatayı bildirir.

Bu alanları izleyin

  • yaşam döngüsü durumu için status
  • genel bir ilerleme sinyali için progress
  • sağlayıcı işi reddettiğinde veya iş başarısız olduğunda error
  • geçici varlıkların ne zaman sona ereceğini bilmeniz gerekiyorsa, tamamlanmadan sonra expires_at

Tamamlanana kadar sorgulayın

1

Önce videoyu oluşturun veya remix yapın

Create Video veya Remix Video ile başlayın.
2

id ile sorgulayın

Döndürülen id değerini burada iletin ve iş completed veya failed durumuna ulaşana kadar kontrol etmeye devam edin.
3

Dosyayı indirin

İş completed olduğunda, Retrieve Video Content adımına geçin.

CometAPI üzerindeki yanıt şekli

Bu adım, Sora polling iş akışıyla yakından eşleşir. CometAPI, OpenAI tarzı nesne şeklini korur; böylece durum kontrollerini minimum çeviriyle bağlayabilirsiniz.

Yetkilendirmeler

Authorization
string
header
gerekli

Bearer token authentication. Use your CometAPI key.

Yol Parametreleri

video_id
string
gerekli

Video id returned by the create or remix endpoint.

Yanıt

200 - application/json

Current job state.

id
string
gerekli
size
string
gerekli
model
string
gerekli
object
string
gerekli
status
string
gerekli
seconds
string
gerekli
progress
integer
gerekli
created_at
integer
gerekli
error
object
prompt
string
expires_at
integer | null
completed_at
integer | null
remixed_from_video_id
string | null