Vai al contenuto principale
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
}
Usa questo endpoint dopo aver avviato un job Sora. Riporta lo stato corrente del job, la dimensione e la durata configurate, ed eventuali errori restituiti dal provider.

​
Tieni d’occhio questi campi

  • status per lo stato del ciclo di vita
  • progress per un’indicazione approssimativa dell’avanzamento
  • error quando il provider rifiuta il job o si verifica un errore
  • expires_at dopo il completamento se hai bisogno di sapere quando scadono le risorse temporanee

​
Esegui il polling fino al completamento

1

Crea o remixa prima il video

Inizia con Create Video o Remix Video.
2

Esegui il polling tramite id

Passa qui l’id restituito e continua a controllare finché il job non raggiunge completed o failed.
3

Scarica il file

Quando il job è completed, passa a Retrieve Video Content.

​
Forma della risposta su CometAPI

Questo passaggio segue da vicino il flusso di polling di Sora. CometAPI mantiene la forma dell’oggetto in stile OpenAI così puoi collegare i controlli di stato con modifiche minime.

Autorizzazioni

​
Authorization
string
header
obbligatorio

Bearer token authentication. Use your CometAPI key.

Parametri del percorso

​
video_id
string
obbligatorio

Video id returned by the create or remix endpoint.

Risposta

200 - application/json

Current job state.

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