Guides d’intégration
Erreurs
Tarification et facturation
API officielle
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 --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
}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
statuspour l’état du cycle de vieprogresspour un indicateur de progression approximatiferrorlorsque le fournisseur rejette la tâche ou qu’elle échoueexpires_ataprès la fin si vous devez savoir quand les ressources temporaires expirent
Interroger jusqu’à la fin
Créer ou remixer la vidéo d’abord
Commencez par Create Video ou Remix Video.
Interroger par id
Passez ici l’
id renvoyé et continuez à vérifier jusqu’à ce que la tâche atteigne completed ou failed.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
Bearer token authentication. Use your CometAPI key.
Paramètres de chemin
Video id returned by the create or remix endpoint.
Réponse
200 - application/json
Current job state.
⌘I
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
}