curl-X POST 'https://pollo.ai/api/platform/v1/generation/openai/sora-2-pro/video'\-H'Content-Type: application/json'\-H'x-api-key: YOUR_API_KEY'\-d'{ "input": { "prompt": "A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field", "duration": 4, "aspectRatio": "16:9", "resolution": "720p" }}'
При желании укажите webhookUrl, чтобы получать обратный вызов в случае успешного или неудачного выполнения задачи.
Необязательное поле запроса
{"input":{"prompt":"A cinematic shot of a golden retriever running through a field of sunflowers at sunset, warm rim light, shallow depth of field","duration":4,"aspectRatio":"16:9","resolution":"720p"},"webhookUrl":"https://example.com/webhooks/pollo"}
Схема
Поля ввода для выбранной конечной точки и режима.
Поле
Тип
Необходимый
Описание
prompt
string
Да
Text prompt describing the content to generate.
duration
number
Нет
The duration of the generated video, in seconds.
aspectRatio
string
Нет
Output aspect ratio, as width:height (e.g. 16:9).
resolution
string
Нет
Output resolution of the generated media (e.g. 720p, 1080p, 2K, 4K). Values are case-insensitive.
Ошибки
Типичные коды ответов общедоступных API.
400
Недопустимые входные данные или ограничения модели.
Sora 2 Pro prend en charge des prompts longs et détaillés et génère des scènes avec des objets coordonnés, un éclairage cohérent, des mouvements physiques réalistes et une continuité visuelle sur tout le clip.
Avec Sora 2 Pro sur l’API Pollo, tu peux intégrer la génération texte-vers-vidéo et image-vers-vidéo, avec des durées de clip configurables, un cadrage portrait ou paysage, et des résolutions de sortie jusqu’à 1080p.
Principales fonctionnalités de l’API Sora 2 Pro
Simulation du monde
Génère des scènes dynamiques tout en conservant le placement et l’apparence des surfaces, des ombres, des objets et des sujets en mouvement à mesure que la caméra et l’action progressent.
Audio synchronisé
Génère des dialogues, ambiances et effets sonores synchronisés avec la vidéo, en alignant les repères audio avec la parole, les mouvements et les événements à l’écran.
Compréhension des prompts longs
Prend en charge des prompts détaillés pour définir plusieurs temps de scène, actions des sujets, mise en scène, direction de caméra et ambiance au sein d’une seule génération.
Durée de clip étendue
Les générations durent 4, 8, 12, 16 ou 20 secondes, idéal pour des actions, dialogues et courtes séquences narratives qui demandent davantage de temps de développement.
Crédibilité physique
Génère des mouvements tenant compte du poids, de l’élan et du contact pour des actions physiques impliquant des objets qui tombent, des liquides, des collisions et des sujets en mouvement.
Résolution premium
La sortie monte jusqu’à 1080p avec des détails nets, en gardant textures, visages et mouvements fins suffisamment précis pour une diffusion finale, et pas seulement pour des aperçus brouillon.
Cas d’usage de l’API Sora 2 Pro
Scènes centrées sur le dialogue : Génère de courts moments parlés où le mouvement des lèvres, le ton et le son ambiant sont alignés, utile pour les applications narratives et les contenus portés par des personnages.
Séquences explicatives : Construis des walkthroughs visuels en plusieurs étapes à partir d’un prompt détaillé, pour laisser les actions et processus se développer sur des clips plus longs.
Environnements simulés : Produis météo, eau, foules et trafic avec des mouvements coordonnés et une continuité de scène pour les workflows de prévisualisation et de world-building.
Contenu narratif vertical : Crée des clips 9:16 adaptés aux flux short-form, avec un audio synchronisé prêt pour les plateformes de storytelling mobile-first.
Prototypage prompt-vers-scène : Génère des interprétations visuelles précoces de scènes détaillées pour évaluer la mise en scène, le rythme, la direction de caméra et la continuité avant production.
Mouvement guidé par l’image : Convertis une image source en vidéo avec mouvement et audio synchronisé tout en préservant son sujet principal, sa composition et sa direction visuelle.
Films conceptuels : Génère des scènes atmosphériques étendues qui exigent une continuité visuelle, narrative et audio soutenue.
Comment utiliser l’API Sora 2 Pro
Obtiens une clé API : Crée un compte API Pollo et génère ta clé depuis le tableau de bord développeur, puis passe-la dans l’en-tête x-api-key.
Choisis le modèle : Envoie ta requête vers l’endpoint Sora 2 Pro à l’adresse /generation/sora/sora-2-pro.
Ajoute tes entrées : Fournis un prompt pour le texte-vers-vidéo, ou une URL image pour l’image-vers-vidéo, puis définis length (4-20), resolution (jusqu’à 1080p) et aspectRatio (16:9 ou 9:16).
Génère et récupère : Soumets la tâche, interroge le statut de tâche renvoyé, ou enregistre un webhook, puis télécharge la vidéo finale une fois la tâche réussie.
Bonnes pratiques de prompting pour l’API Sora 2 Pro
Rédige le prompt comme un brief de scène plutôt qu’une liste de mots-clés. Décris le décor, les sujets, les actions, les dialogues, le son et les mouvements de caméra pour guider la structure de la scène et la continuité globale.
Une formule de prompt simple
Décor et atmosphère + sujet et action spécifique + dialogue ou repère sonore + mouvement de caméra + rythme adapté à la durée
Ce que tu dois remarquer
Pose le monde d’abord : Indique le lieu, le moment de la journée et l’ambiance pour que l’environnement reste cohérent sur tout le clip.
Donne des repères audio : Inclus dialogue parlé, son ambiant, musique ou effets sonores pour guider la sortie audio synchronisée.
Ajuste le rythme à la durée : Adapte le nombre et la complexité des actions selon la longueur de clip sélectionnée.
Mets le mouvement en scène : Précise comment les sujets et la caméra bougent ensemble pour garder une simulation crédible et lisible.
Rends la continuité explicite : Décris ce qui doit persister, comme les vêtements d’un personnage ou une source lumineuse, afin de maintenir la cohérence sur des plans plus longs.
Exemples de prompts
Scène de marché détrempé par la pluie
"Un marché de nuit bondé sous la pluie, des vendeurs qui interpellent sous des guirlandes lumineuses, de la vapeur qui monte des stands de nourriture. Un client marchande, rit et tend des espèces. Plan de suivi lent à travers la foule, brouhaha ambiant et grésillement, 12 secondes."
Moment de dialogue en cuisine
"Une grand-mère remue une marmite et dit : 'Goûte ça, dis-moi s’il faut du sel', pendant qu’un ado se penche et goûte. Lumière chaude d’après-midi, léger rapprochement caméra, cuillères qui s’entrechoquent et voix douces synchronisées à leurs mouvements."
Étude de physique côtière
"Des vagues déferlent sur une côte rocheuse, des embruns éclatent à l’impact puis se retirent avec le reflux, des mouettes traversent le ciel. Plan large fixe, lumière naturelle du matin, couches de sons d’océan et de vent, maintenues sur un long clip."
Session de skate verticale
"Un skateur descend une rampe vide de parking couvert, roues qui vibrent sur les joints du béton, planche qui claque à chaque virage. Cadrage vertical 9:16, caméra qui suit de près derrière, acoustique réverbérée du parking, rythme rapide et assuré."
Sora 2 Pro vs Veo 3.1 vs Kling 2.6
Capacité
Sora 2 Pro
Veo 3.1
Kling 2.6
Simulation du monde et cohérence
✅ Forte constance sur longues scènes
✅ Fort contrôle de scène
✅ Bon mouvement, moins centré sur le monde
Audio synchronisé
✅
✅
❌ Limité
Durée maximale du clip
Jusqu’à 20 secondes
Clips courts dirigés
Clips courts dirigés
Options de résolution
720p, 1024p, 1080p
Jusqu’à 1080p
Jusqu’à 1080p
Modes d’entrée
Texte et image
Texte, image, référence
Texte et image
Recommandé pour
Scènes longues, sonorisées et cohérentes
Plans cinématographiques contrôlés
Mouvement fluide des personnages
Pourquoi choisir l’API Sora 2 Pro ?
Sora 2 Pro convient aux applications qui exigent des scènes étendues, un audio synchronisé et une continuité visuelle. La prise en charge du dialogue, des environnements simulés et de clips jusqu’à 20 secondes le rend adapté au storytelling, aux contenus explicatifs, à la prévisualisation et aux workflows de contenu basés sur des scènes.
Via l’API Pollo, Sora 2 Pro est accessible aux côtés d’autres modèles vidéo et image via une seule API, avec prise en charge de l’interrogation du statut des tâches et des webhooks, ce qui simplifie l’évaluation des modèles, l’intégration et le déploiement.
FAQ de l’API Sora 2 Pro
Qu’est-ce que Sora 2 Pro ?
Sora 2 Pro est le modèle vidéo premium d’OpenAI qui simule des environnements réalistes avec audio synchronisé et forte cohérence, en prenant en charge le texte-vers-vidéo et l’image-vers-vidéo jusqu’à 20 secondes.
L’API Sora 2 Pro prend-elle en charge les entrées texte et image ?
Oui. Tu peux générer à partir d’un prompt écrit ou animer une URL d’image, ce qui la rend flexible pour les workflows orientés idée d’abord comme pour ceux orientés assets d’abord.
Quelle peut être la durée des clips Sora 2 Pro ?
Les clips peuvent durer 4, 8, 12, 16 ou 20 secondes, offrant plus d’espace que la plupart des modèles pour faire aboutir actions et dialogues dans une seule génération.
Sora 2 Pro génère-t-il de l’audio ?
Oui. Il produit du son synchronisé, en alignant dialogue et audio ambiant avec les mouvements à l’écran afin que la parole et les événements restent calés avec les images.
Quelles résolutions et quels cadrages sont disponibles ?
Sora 2 Pro sort jusqu’en 1080p en cadrage large 16:9 ou vertical 9:16, sélectionné à la demande pour correspondre à ton format de diffusion.
Pourquoi exécuter Sora 2 Pro via l’API Pollo ?
L’API Pollo donne accès à Sora 2 Pro ainsi qu’à d’autres modèles vidéo et image via une seule intégration, avec documentation API, suivi du statut des tâches et support webhook pour la génération vidéo asynchrone.
