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

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 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-2 pour itérer plus rapidement ou sora-2-pro lorsque la qualité de sortie est plus importante que la vitesse
  • Gardez seconds à 4 pour votre première requête
  • Commencez avec size: 1280x720 sauf si vous avez spécifiquement besoin d’un format portrait
  • Importez au maximum une image de référence

​
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 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

​
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 a current model from the Models page.

Exemple:

"sora-2"

​
seconds
enum<string>
défaut:4

Clip duration in seconds.

Options disponibles:
4,
8,
12
Exemple:

"4"

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

Output resolution formatted as width x height.

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