Guides d’intégration
Erreurs
Tarification et facturation
API officielle
Créer une vidéo
Utilisez POST /v1/videos pour créer des tâches de génération vidéo Sora 2 à partir de prompts textuels ou d’images de référence, puis interrogez le statut par ID de tâche pour obtenir les résultats.
POST
/
v1
/
videos
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}Utilisez cet endpoint pour démarrer une nouvelle tâche de rendu Sora à partir de texte, ou de texte plus une image de référence. L’API renvoie immédiatement un identifiant de vidéo et n’attend pas la fin du rendu.
Commencez par la plus petite tâche utile
- Utilisez
sora-2pour itérer plus rapidement ousora-2-prolorsque la qualité de sortie est plus importante que la vitesse - Gardez
secondsà4pour votre première requête - Commencez avec
size: 1280x720sauf si vous avez spécifiquement besoin d’un format portrait - Importez au maximum une image de référence
Flux de bout en bout
Interroger jusqu’à la fin de la tâche
Appelez Retrieve Video jusqu’à ce que le statut devienne
completed ou failed.Télécharger ou remixer le résultat
Une fois le rendu terminé, récupérez le fichier avec Retrieve Video Content. Si vous souhaitez une variation ciblée, utilisez Remix Video sur le résultat terminé.
Comportement de Sora qui s’applique toujours
OpenAI documente le même flux create -> retrieve -> download dans l’API Videos. Sur CometAPI, vous conservez le format de requête Sora, mais utilisez l’URL de base et la clé CometAPI. Les URL de téléchargement des résultats sont temporaires, donc copiez les ressources terminées dans votre propre stockage si vous avez besoin d’une conservation longue durée.Autorisations
Bearer token authentication. Use your CometAPI key.
Corps
multipart/form-data
Text prompt that describes the video you want to create.
Exemple:
"A paper airplane glides across a desk."
Sora model ID. Choose a current model from the Models page.
Exemple:
"sora-2"
Clip duration in seconds.
Options disponibles:
4, 8, 12 Exemple:
"4"
Output resolution formatted as width x height.
Options disponibles:
720x1280, 1280x720, 1024x1792, 1792x1024 Exemple:
"1280x720"
Optional reference image uploaded as a file. The image should match the target size you request.
⌘I
Create a Sora video job
curl --request POST \
--url https://api.cometapi.com/v1/videos \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form 'prompt=A paper airplane glides across a desk.' \
--form input_reference='@example-file'{
"created_at": 1773296991,
"id": "video_69b25d5f467c81908733a56bc236b4df",
"model": "sora-2",
"object": "video",
"progress": 0,
"seconds": "4",
"size": "1280x720",
"status": "queued"
}