Récupérer une vidéo

Utilisez CometAPI GET /v1/videos/ pour récupérer le statut, la progression et les métadonnées d’une vidéo Sora 2, comme la durée, les dimensions, les horodatages et l’expiration.

GET /v1/videos/{video_id}

Retrieve a Sora video job

cURL

curl --request GET \
  --url https://api.cometapi.com/v1/videos/{video_id} \
  --header 'Authorization: Bearer <token>'

200

{
  "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
}

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