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
}

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

Use this file to discover all available pages before exploring further.

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