Passer au contenu principal
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.

Utilisez ce endpoint après avoir démarré une tâche Sora. Il indique l’état actuel de la tâche, la taille et la durée configurées, ainsi que toute erreur renvoyée par le fournisseur.

​
Surveillez ces champs

  • status pour l’état du cycle de vie
  • progress pour un indicateur de progression approximatif
  • error lorsque le fournisseur rejette la tâche ou qu’elle échoue
  • expires_at après la fin si vous devez savoir quand les ressources temporaires expirent

​
Interroger jusqu’à la fin

1

Créer ou remixer la vidéo d’abord

Commencez par Create Video ou Remix Video.
2

Interroger par id

Passez ici l’id renvoyé et continuez à vérifier jusqu’à ce que la tâche atteigne completed ou failed.
3

Télécharger le fichier

Lorsque la tâche est completed, passez à Retrieve Video Content.

​
Forme de la réponse sur CometAPI

Cette étape correspond de près au workflow d’interrogation Sora. CometAPI conserve la forme d’objet de style OpenAI afin que vous puissiez intégrer les vérifications de statut avec un minimum d’adaptation.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Paramètres de chemin

​
video_id
string
requis

Video id returned by the create or remix endpoint.

Réponse

200 - application/json

Current job state.

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