Zum Hauptinhalt springen
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
}
Verwenden Sie diesen Endpoint, nachdem Sie einen Sora-Job gestartet haben. Er meldet den aktuellen Jobstatus, die konfigurierte Größe und Dauer sowie alle vom Provider zurückgegebenen Fehler.

Achten Sie auf diese Felder

  • status für den Lebenszyklusstatus
  • progress für ein grobes Fortschrittssignal
  • error, wenn der Provider den Job ablehnt oder er fehlschlägt
  • expires_at nach Abschluss, wenn Sie wissen müssen, wann temporäre Assets ablaufen

Bis zum Abschluss abfragen

1

Erstellen oder remixen Sie zuerst das Video

Beginnen Sie mit Create Video oder Remix Video.
2

Per id abfragen

Übergeben Sie hier die zurückgegebene id und prüfen Sie weiter, bis der Job completed oder failed erreicht.
3

Die Datei herunterladen

Wenn der Job completed ist, wechseln Sie zu Retrieve Video Content.

Antwortstruktur in CometAPI

Dieser Schritt entspricht dem Sora-Polling-Workflow sehr genau. CometAPI behält die Objektstruktur im OpenAI-Stil bei, sodass Sie Statusprüfungen mit minimalem Anpassungsaufwand verdrahten können.

Autorisierungen

Authorization
string
header
erforderlich

Bearer token authentication. Use your CometAPI key.

Pfadparameter

video_id
string
erforderlich

Video id returned by the create or remix endpoint.

Antwort

200 - application/json

Current job state.

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