Skip to main content
POST
Utilisez ce endpoint pour démarrer une tâche de rendu Sora à partir de texte, ou de texte plus une image de référence. L’API renvoie immédiatement un id de vidéo et n’attend pas la fin du rendu.

​
Commencez par la plus petite tâche utile

  • Utilisez sora-2 pour itérer plus rapidement ou sora-2-pro lorsque la qualité de sortie compte davantage que la vitesse
  • Gardez seconds à 4 pour votre première requête
  • Commencez avec size: 1280x720 sauf si vous avez spécifiquement besoin d’une sortie en portrait
  • Téléversez au maximum une image de référence

​
Durée et taille

Sora exige que le champ size soit au format exact WxH. Les indications de résolution comme 720p et les libellés de ratio comme 16:9 ne sont pas des valeurs size valides pour Sora sur ce endpoint.

​
Flux de bout en bout

1

Créer la tâche de rendu

Envoyez model, prompt, seconds et size, puis enregistrez l’id renvoyé.
2

Interroger jusqu’à la fin de la tâche

Appelez Retrieve Video jusqu’à ce que le statut devienne completed ou failed.
3

Télécharger le résultat

Quand le rendu est terminé, récupérez le fichier avec Retrieve Video Content.

​
Comportement 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 terminées sont temporaires, donc copiez les ressources finalisées dans votre propre stockage si vous avez besoin d’une conservation longue.

Autorisations

​
Authorization
string
header
requis

Bearer token authentication. Use your CometAPI key.

Corps

multipart/form-data
​
prompt
string
requis

Text prompt that describes the video you want to create.

Exemple:

"A paper airplane glides across a desk."

​
model
string
défaut:sora-2

Sora model ID. Choose an available model from the Models page.

Exemple:

"sora-2"

​
seconds
enum<string>
défaut:4

Clip duration in seconds. Use 4, 8, 12, 16, or 20.

Options disponibles:
4,
8,
12,
16,
20
Exemple:

"4"

​
size
enum<string>
défaut:1280x720

Output resolution formatted as width x height. Use 1280x720 or 720x1280 for standard Sora output. Use 1792x1024 or 1024x1792 with a Pro model when you need larger Pro output.

Options disponibles:
720x1280,
1280x720,
1024x1792,
1792x1024
Exemple:

"1280x720"

​
input_reference
file

Optional reference image uploaded as a file. The image should match the target size you request.

Réponse

200 - application/json

Video job accepted.

​
created_at
integer
requis
​
id
string
requis
​
model
string
requis
​
object
string
requis
​
progress
integer
requis
​
seconds
string
requis
​
size
string
requis
​
status
string
requis