Génération vidéo Sora-2
- Sora 2 Preview (sora-2-preview) prend en charge texte-vers-vidéo, image-vers-vidéo et plus
- Traitement asynchrone, utilisez l’ID de tâche retourné pour consulter le statut
- Les liens vidéo générés sont valides pendant 24 heures, veuillez les sauvegarder rapidement
Note :
- Sora2 a une modération de contenu très stricte, les tâches peuvent échouer pour cette raison
- Les images de personnes réelles ne sont pas prises en charge
Autorisations
##Toutes les API nécessitent une authentification Bearer Token##
Obtenir une clé API :
Visitez la Page de gestion des clés API pour obtenir votre clé API
Ajouter à l'en-tête de requête :
Corps
Nom du modèle de génération vidéo
"sora-2-preview"
Prompt décrivant la vidéo à générer, max 5000 tokens
5000"A cat playing piano"
Rapport d'aspect vidéo. 1280x720 génère une vidéo en paysage, 720x1280 génère une vidéo en portrait
1280x720, 720x1280, 16:9, 9:16 "16:9"
Durée de la vidéo (secondes), par défaut 4
Note :
- Prend uniquement en charge
4,8,12secondes - Une durée plus longue coûte plus cher
4
URLs d'images de référence pour image-vers-vidéo
Note :
- Les images de personnes réelles ne sont pas prises en charge
- Maximum 1 image par requête
- Taille maximale : 10MB
- Formats : .jpg, .jpeg, .png, .webp
- Les dimensions en pixels de l'image doivent correspondre exactement au aspect_ratio sélectionné (par ex., si aspect_ratio est
1280x720, l'image téléchargée doit être exactement de 1280x720 pixels) - L'URL de l'image doit être directement accessible par le serveur, ou déclencher un téléchargement lors de l'accès (généralement des URLs se terminant par des extensions d'image comme .png, .jpg)
1URL de rappel HTTPS pour l'achèvement de la tâche
Moment du rappel :
- Déclenché lorsque la tâche est terminée, échouée ou annulée
- Envoyé après la confirmation de la facturation
Restrictions de sécurité :
- Protocole HTTPS uniquement
- Adresses IP privées non autorisées (127.0.0.1, 10.x.x.x, 172.16-31.x.x, 192.168.x.x, etc.)
- Longueur maximale de l'URL : 2048 caractères
Mécanisme de rappel :
- Délai d'expiration : 10 secondes
- Maximum 3 tentatives en cas d'échec (à intervalles de 1s/2s/4s)
- Le format de réponse correspond à l'API de consultation de tâche
- Code de statut 2xx = succès, les autres codes déclenchent une nouvelle tentative
"https://your-domain.com/webhooks/video-task-completed"
Réponse
Tâche de génération vidéo créée avec succès
Horodatage de création de la tâche
1757169743
ID de tâche
"task-unified-1757169743-7cvnl5zw"
Nom du modèle utilisé
"sora-2-preview"
Type de tâche
video.generation.task Progression de la tâche (0-100)
0 <= x <= 1000
Statut de la tâche
pending, processing, completed, failed "pending"
Type de sortie
text, image, audio, video "video"