Génération de vidéos Sora
Générez des vidéos IA via l'API OpenAI Sora d'AceDataCloud.
Configuration : Voir authentification pour configurer le jeton.
Démarrage rapide
curl -X POST https://api.acedata.cloud/sora/videos \
-H "Authorization: Bearer $ACEDATACLOUD_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{"prompt": "un golden retriever courant sur une plage au coucher du soleil", "model": "sora-2", "callback_url": "https://api.acedata.cloud/health"}'
Async : Voir interrogation de tâches asynchrones. Interrogez via
POST /sora/tasksavec{"id": "..."}.
Modèles
| Modèle | Durée | Qualité | Idéal pour |
|---|---|---|---|
sora-2 | 10–15 s | Standard | La plupart des tâches (par défaut) |
sora-2-pro | 10–25 s | Supérieure | Qualité premium, vidéos plus longues |
Workflows
1. Texte vers vidéo
POST /sora/videos
{
"prompt": "une rue animée de Tokyo la nuit avec des enseignes au néon se reflétant dans les flaques de pluie",
"model": "sora-2",
"size": "small",
"duration": 10,
"orientation": "landscape"
}
2. Image vers vidéo
Utilisez des images de référence pour guider la génération.
POST /sora/videos
{
"prompt": "la scène s'anime progressivement avec un mouvement doux",
"image_urls": ["https://example.com/scene.jpg"],
"model": "sora-2",
"orientation": "landscape"
}
3. Vidéo basée sur un personnage
Extrayez un personnage d'une vidéo existante et utilisez-le dans une nouvelle scène.
POST /sora/videos
{
"prompt": "le personnage marche dans une ville futuriste",
"character_url": "https://example.com/source-video.mp4",
"character_start": 2.0,
"character_end": 5.0,
"model": "sora-2-pro"
}
Paramètres
| Paramètre | Valeurs | Description |
|---|---|---|
model | "sora-2", "sora-2-pro" | Modèle à utiliser (obligatoire) |
size | "small", "large" | Résolution de la vidéo |
duration | 10, 15, 25 | Durée en secondes (25 uniquement avec sora-2-pro) |
orientation | "landscape" (16:9), "portrait" (9:16), "square" (1:1) | Orientation de la vidéo |
version | "1.0" | Version de l'API — la version 1.0 permet une durée jusqu'à 25s, l'orientation, les références de personnages et les entrées d'images |
Pièges
- La durée de 25 secondes est uniquement disponible avec le modèle
sora-2-pro size: "large"produit une résolution plus élevée mais coûte plus cher et prend plus de temps- La génération basée sur un personnage nécessite les horodatages
character_startetcharacter_end(en secondes) de la vidéo source orientationdéfinit le rapport hauteur/largeur — utilisez"portrait"pour un contenu prioritairement mobile- Les états de tâche utilisent
"succeeded"(et non "completed") — vérifiez cette valeur lors de l'interrogation
MCP :
pip install mcp-sora| Hébergé :https://sora.mcp.acedata.cloud/mcp| Voir tous les serveurs MCP