Sora 2 est le modèle de génération vidéo et audio d’OpenAI pour des clips dynamiques créés à partir d’une description écrite de scène ou d’une image de référence. Il génère la séquence visuelle avec des paroles, des effets et une ambiance sonore synchronisés. Le profil Sora 2 standard est destiné à l’exploration visuelle, au développement de concepts, aux prototypes et aux premiers montages. Sora 2 Pro est une édition distincte visant une fidélité visuelle accrue et une finition en plus haute résolution.
Le guide de prompting du concepteur organise un brief utile autour du cadrage, du sujet, de l’action, du décor et de la lumière. Donnez à la scène un style visuel cohérent, puis décrivez le mouvement en temps clairement définis. Un concept de produit original pourrait montrer un petit objet mécanique faisant un tour sur un établi tandis que la caméra s’approche lentement, avec une douce lumière de fenêtre et un léger bruit de moteur. Précisez ce que le spectateur doit remarquer et comment l’action se termine.
Rendez compréhensibles le mouvement de caméra et l’action du sujet dans chaque plan. Une séquence complexe peut être divisée en blocs de plans distincts, chacun avec son cadrage, son action et son éclairage. Conservez les mêmes détails du sujet et la même palette lorsque plusieurs clips doivent former une seule séquence. Le guide souligne que les plans courts suivent généralement les consignes de façon plus fiable et que des générations répétées à partir du même prompt produisent des prises différentes.
La présentation de lancement du modèle décrit un meilleur comportement physique et une meilleure continuité entre les plans, notamment dans les styles réaliste, cinématographique et anime. Il s’agit de capacités à diriger et à examiner. Vérifiez le mouvement, le contact entre les objets, les proportions et la continuité, sans supposer qu’une première image plausible garantit une séquence cohérente. Si une action manque de clarté, simplifiez-la et donnez-lui un début et une fin visibles.
Précisez les répliques séparément de la description visuelle et identifiez les locuteurs de façon constante. Gardez des dialogues assez courts pour correspondre à l’action et à la durée prévue du clip. Pour une animation à deux personnages, alternez une brève question et sa réponse plutôt que d’imposer un long discours à un plan court. Le guide avertit que des dialogues longs et complexes peuvent perturber le rythme et la synchronisation.
Décrivez l’environnement sonore propre à la scène : le son d’un petit mouvement, l’ambiance d’une pièce ou le rythme d’un effet environnemental. Expliquez quel son doit coïncider avec l’action. Écoutez les paroles et les effets obtenus en regardant l’image, et vérifiez l’attribution des voix, les mots et le timing. L’audio synchronisé fait partie du clip généré ; il ne s’agit pas d’une réponse textuelle séparée.
Les dimensions de sortie documentées pour le modèle standard sont 720×1280 en portrait et 1280×720 en paysage. Les dimensions de plus haute résolution du profil Pro ne doivent pas être attribuées à Sora 2 standard. Les dimensions et la durée sont des paramètres explicites de la requête ; écrire une autre taille ou demander un film plus long dans le prompt ne modifie pas ces paramètres. La référence de création indique des durées de clip de 4, 8 et 12 secondes : préparez donc un temps d’action court et défini pour chaque plan. Le processus étendu du fournisseur documente également des durées de 16 et 20 secondes.
Une image de référence ancre la première image de la vidéo et le texte décrit ce qui se passe ensuite. Le fournisseur accepte les références JPEG, PNG et WebP et exige que l’image corresponde aux dimensions de la vidéo cible. Préparez le sujet, l’environnement et la composition dans cette image d’ouverture, puis demandez un mouvement précis. Cette référence définit la première image ; elle ne garantit pas que chaque détail restera identique tout au long du clip.
Le processus étendu du fournisseur permet de créer une ressource de personnage réutilisable à partir d’une courte vidéo de référence d’un animal, d’une mascotte ou d’un objet. Ses consignes de préparation prévoient un clip MP4 d’environ deux à quatre secondes, de 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre le rapport largeur/hauteur de la source à celui de la sortie permet d’éviter un aspect étiré. La génération peut faire référence à deux personnages au maximum.
Conservez l’identifiant du personnage et mentionnez son nom dans le prompt ; transmettre uniquement l’identifiant ne constitue pas la préparation complète décrite par le guide. Les ressources de personnages peuvent accompagner une génération guidée par une image, mais les prolongements vidéo ne les acceptent pas. Le fournisseur bloque par défaut les imports de personnages à apparence humaine et refuse les images de référence contenant des visages humains dans le processus API documenté. Les fonctionnalités de personnages personnels de l’application Sora relèvent d’un processus produit distinct.
Un prolongement utilise une vidéo source terminée et un prompt de continuation, en prenant l’intégralité du clip source comme contexte pour le mouvement, la direction de caméra et la continuité de la scène. Le guide décrit des ajouts allant jusqu’à 20 secondes par prolongement. L’entrée documentée pour un prolongement comprend la vidéo source et le texte ; les références supplémentaires de personnages ou d’images sont exclues de ce mode. Décrivez comment l’action existante se poursuit au lieu d’introduire une scène sans rapport et sans transition.
La retouche vidéo vise une modification claire d’un clip existant. Une révision ciblée peut changer la couleur d’un objet ou la palette de la scène tout en conservant le reste du plan. Le guide du fournisseur recommande une seule modification bien définie à la fois et distingue la retouche d’une vidéo générée de l’import de séquences quelconques, soumis à une condition d’éligibilité distincte. Conservez la source terminée et indiquez précisément la révision attendue avant de procéder à une nouvelle retouche.
Le processus vidéo documenté du fournisseur est asynchrone : une tâche soumise peut être en file d’attente ou en cours avant de se terminer ou d’échouer. Une tâche terminée fournit une vidéo MP4 ; les vignettes et les planches de sprites servent à la prévisualisation et à la navigation. Conservez l’identité de la tâche avec le prompt, les références et les ressources renvoyées. La réponse initiale à la soumission d’une tâche n’est pas la vidéo finale lisible.
Le processus de téléchargement ordinaire indique une durée de validité d’une heure pour l’URL de téléchargement. Le processus par lots étendu prépare des requêtes de rendu JSON indépendantes, avec des identifiants d’éléments stables, des références importées et un résultat associé à chaque plan ; ses ressources terminées disposent d’une période de téléchargement distincte pouvant atteindre 24 heures. Enregistrez rapidement le clip terminé et examinez l’image et le son réels avant de le considérer comme une prise retenue.
Les restrictions de contenu documentées pour l’API du fournisseur exigent des contenus adaptés aux moins de 18 ans et refusent les personnages ou la musique protégés par le droit d’auteur ainsi que la génération de personnes réelles. Préparez la scène et les références en conséquence. Le résultat direct du modèle est une vidéo avec audio, et non des images fixes générées, une réponse conversationnelle d’outil ou un film de durée illimitée. Conservez l’identité exacte du modèle standard et le clip source accepté lorsque vous poursuivez un concept visuel.
", "aboutText": "Sora 2 est le modèle de génération vidéo et audio d’OpenAI pour des clips dynamiques créés à partir d’une description écrite de scène ou d’une image de référence. Il génère la séquence visuelle avec des paroles, des effets et une ambiance sonore synchronisés. Le profil Sora 2 standard est destiné à l’exploration visuelle, au développement de concepts, aux prototypes et aux premiers montages. Sora 2 Pro est une édition distincte visant une fidélité visuelle accrue et une finition en plus haute résolution.\n\n### Décrivez un plan que l’on peut voir et entendre\n\nLe guide de prompting du concepteur organise un brief utile autour du cadrage, du sujet, de l’action, du décor et de la lumière. Donnez à la scène un style visuel cohérent, puis décrivez le mouvement en temps clairement définis. Un concept de produit original pourrait montrer un petit objet mécanique faisant un tour sur un établi tandis que la caméra s’approche lentement, avec une douce lumière de fenêtre et un léger bruit de moteur. Précisez ce que le spectateur doit remarquer et comment l’action se termine.\n\nRendez compréhensibles le mouvement de caméra et l’action du sujet dans chaque plan. Une séquence complexe peut être divisée en blocs de plans distincts, chacun avec son cadrage, son action et son éclairage. Conservez les mêmes détails du sujet et la même palette lorsque plusieurs clips doivent former une seule séquence. Le guide souligne que les plans courts suivent généralement les consignes de façon plus fiable et que des générations répétées à partir du même prompt produisent des prises différentes.\n\nLa présentation de lancement du modèle décrit un meilleur comportement physique et une meilleure continuité entre les plans, notamment dans les styles réaliste, cinématographique et anime. Il s’agit de capacités à diriger et à examiner. Vérifiez le mouvement, le contact entre les objets, les proportions et la continuité, sans supposer qu’une première image plausible garantit une séquence cohérente. Si une action manque de clarté, simplifiez-la et donnez-lui un début et une fin visibles.\n\n### Dirigez séparément les dialogues et le son\n\nPrécisez les répliques séparément de la description visuelle et identifiez les locuteurs de façon constante. Gardez des dialogues assez courts pour correspondre à l’action et à la durée prévue du clip. Pour une animation à deux personnages, alternez une brève question et sa réponse plutôt que d’imposer un long discours à un plan court. Le guide avertit que des dialogues longs et complexes peuvent perturber le rythme et la synchronisation.\n\nDécrivez l’environnement sonore propre à la scène : le son d’un petit mouvement, l’ambiance d’une pièce ou le rythme d’un effet environnemental. Expliquez quel son doit coïncider avec l’action. Écoutez les paroles et les effets obtenus en regardant l’image, et vérifiez l’attribution des voix, les mots et le timing. L’audio synchronisé fait partie du clip généré ; il ne s’agit pas d’une réponse textuelle séparée.\n\n### Dimensions, durée et ouverture guidée par une image\n\nLes dimensions de sortie documentées pour le modèle standard sont 720×1280 en portrait et 1280×720 en paysage. Les dimensions de plus haute résolution du profil Pro ne doivent pas être attribuées à Sora 2 standard. Les dimensions et la durée sont des paramètres explicites de la requête ; écrire une autre taille ou demander un film plus long dans le prompt ne modifie pas ces paramètres. La référence de création indique des durées de clip de 4, 8 et 12 secondes : préparez donc un temps d’action court et défini pour chaque plan. Le processus étendu du fournisseur documente également des durées de 16 et 20 secondes.\n\nUne image de référence ancre la première image de la vidéo et le texte décrit ce qui se passe ensuite. Le fournisseur accepte les références JPEG, PNG et WebP et exige que l’image corresponde aux dimensions de la vidéo cible. Préparez le sujet, l’environnement et la composition dans cette image d’ouverture, puis demandez un mouvement précis. Cette référence définit la première image ; elle ne garantit pas que chaque détail restera identique tout au long du clip.\n\n### Personnages non humains réutilisables\n\nLe processus étendu du fournisseur permet de créer une ressource de personnage réutilisable à partir d’une courte vidéo de référence d’un animal, d’une mascotte ou d’un objet. Ses consignes de préparation prévoient un clip MP4 d’environ deux à quatre secondes, de 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre le rapport largeur/hauteur de la source à celui de la sortie permet d’éviter un aspect étiré. La génération peut faire référence à deux personnages au maximum.\n\nConservez l’identifiant du personnage et mentionnez son nom dans le prompt ; transmettre uniquement l’identifiant ne constitue pas la préparation complète décrite par le guide. Les ressources de personnages peuvent accompagner une génération guidée par une image, mais les prolongements vidéo ne les acceptent pas. Le fournisseur bloque par défaut les imports de personnages à apparence humaine et refuse les images de référence contenant des visages humains dans le processus API documenté. Les fonctionnalités de personnages personnels de l’application Sora relèvent d’un processus produit distinct.\n\n### Prolongez ou modifiez un clip terminé\n\nUn prolongement utilise une vidéo source terminée et un prompt de continuation, en prenant l’intégralité du clip source comme contexte pour le mouvement, la direction de caméra et la continuité de la scène. Le guide décrit des ajouts allant jusqu’à 20 secondes par prolongement. L’entrée documentée pour un prolongement comprend la vidéo source et le texte ; les références supplémentaires de personnages ou d’images sont exclues de ce mode. Décrivez comment l’action existante se poursuit au lieu d’introduire une scène sans rapport et sans transition.\n\nLa retouche vidéo vise une modification claire d’un clip existant. Une révision ciblée peut changer la couleur d’un objet ou la palette de la scène tout en conservant le reste du plan. Le guide du fournisseur recommande une seule modification bien définie à la fois et distingue la retouche d’une vidéo générée de l’import de séquences quelconques, soumis à une condition d’éligibilité distincte. Conservez la source terminée et indiquez précisément la révision attendue avant de procéder à une nouvelle retouche.\n\n### Tâches de rendu et vidéo terminée\n\nLe processus vidéo documenté du fournisseur est asynchrone : une tâche soumise peut être en file d’attente ou en cours avant de se terminer ou d’échouer. Une tâche terminée fournit une vidéo MP4 ; les vignettes et les planches de sprites servent à la prévisualisation et à la navigation. Conservez l’identité de la tâche avec le prompt, les références et les ressources renvoyées. La réponse initiale à la soumission d’une tâche n’est pas la vidéo finale lisible.\n\nLe processus de téléchargement ordinaire indique une durée de validité d’une heure pour l’URL de téléchargement. Le processus par lots étendu prépare des requêtes de rendu JSON indépendantes, avec des identifiants d’éléments stables, des références importées et un résultat associé à chaque plan ; ses ressources terminées disposent d’une période de téléchargement distincte pouvant atteindre 24 heures. Enregistrez rapidement le clip terminé et examinez l’image et le son réels avant de le considérer comme une prise retenue.\n\nLes restrictions de contenu documentées pour l’API du fournisseur exigent des contenus adaptés aux moins de 18 ans et refusent les personnages ou la musique protégés par le droit d’auteur ainsi que la génération de personnes réelles. Préparez la scène et les références en conséquence. Le résultat direct du modèle est une vidéo avec audio, et non des images fixes générées, une réponse conversationnelle d’outil ou un film de durée illimitée. Conservez l’identité exacte du modèle standard et le clip source accepté lorsque vous poursuivez un concept visuel.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "3e711fce6720c11eccfb0317be6643125482b055dc21959e765104dd3ba5b85f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "fr-be", "methods": [ { "html": "sora-2Sora 2 crée des vidéos avec dialogues, effets sonores et ambiance audio synchronisés à partir d’un texte ou d’une image de référence. Le profil standard permet l’exploration visuelle et la création de clips conceptuels ; le fournisseur propose des processus distincts pour les personnages non humains réutilisables, les prolongements et les retouches vidéo ciblées.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Sora 2 est le modèle de génération vidéo et audio d’OpenAI pour des clips dynamiques créés à partir d’une description écrite de scène ou d’une image de référence. Il génère la séquence visuelle avec des paroles, des effets et une ambiance sonore synchronisés. Le profil Sora 2 standard est destiné à l’exploration visuelle, au développement de concepts, aux prototypes et aux premiers montages. Sora 2 Pro est une édition distincte visant une fidélité visuelle accrue et une finition en plus haute résolution.
Le guide de prompting du concepteur organise un brief utile autour du cadrage, du sujet, de l’action, du décor et de la lumière. Donnez à la scène un style visuel cohérent, puis décrivez le mouvement en temps clairement définis. Un concept de produit original pourrait montrer un petit objet mécanique faisant un tour sur un établi tandis que la caméra s’approche lentement, avec une douce lumière de fenêtre et un léger bruit de moteur. Précisez ce que le spectateur doit remarquer et comment l’action se termine.
Rendez compréhensibles le mouvement de caméra et l’action du sujet dans chaque plan. Une séquence complexe peut être divisée en blocs de plans distincts, chacun avec son cadrage, son action et son éclairage. Conservez les mêmes détails du sujet et la même palette lorsque plusieurs clips doivent former une seule séquence. Le guide souligne que les plans courts suivent généralement les consignes de façon plus fiable et que des générations répétées à partir du même prompt produisent des prises différentes.
La présentation de lancement du modèle décrit un meilleur comportement physique et une meilleure continuité entre les plans, notamment dans les styles réaliste, cinématographique et anime. Il s’agit de capacités à diriger et à examiner. Vérifiez le mouvement, le contact entre les objets, les proportions et la continuité, sans supposer qu’une première image plausible garantit une séquence cohérente. Si une action manque de clarté, simplifiez-la et donnez-lui un début et une fin visibles.
Précisez les répliques séparément de la description visuelle et identifiez les locuteurs de façon constante. Gardez des dialogues assez courts pour correspondre à l’action et à la durée prévue du clip. Pour une animation à deux personnages, alternez une brève question et sa réponse plutôt que d’imposer un long discours à un plan court. Le guide avertit que des dialogues longs et complexes peuvent perturber le rythme et la synchronisation.
Décrivez l’environnement sonore propre à la scène : le son d’un petit mouvement, l’ambiance d’une pièce ou le rythme d’un effet environnemental. Expliquez quel son doit coïncider avec l’action. Écoutez les paroles et les effets obtenus en regardant l’image, et vérifiez l’attribution des voix, les mots et le timing. L’audio synchronisé fait partie du clip généré ; il ne s’agit pas d’une réponse textuelle séparée.
Les dimensions de sortie documentées pour le modèle standard sont 720×1280 en portrait et 1280×720 en paysage. Les dimensions de plus haute résolution du profil Pro ne doivent pas être attribuées à Sora 2 standard. Les dimensions et la durée sont des paramètres explicites de la requête ; écrire une autre taille ou demander un film plus long dans le prompt ne modifie pas ces paramètres. La référence de création indique des durées de clip de 4, 8 et 12 secondes : préparez donc un temps d’action court et défini pour chaque plan. Le processus étendu du fournisseur documente également des durées de 16 et 20 secondes.
Une image de référence ancre la première image de la vidéo et le texte décrit ce qui se passe ensuite. Le fournisseur accepte les références JPEG, PNG et WebP et exige que l’image corresponde aux dimensions de la vidéo cible. Préparez le sujet, l’environnement et la composition dans cette image d’ouverture, puis demandez un mouvement précis. Cette référence définit la première image ; elle ne garantit pas que chaque détail restera identique tout au long du clip.
Le processus étendu du fournisseur permet de créer une ressource de personnage réutilisable à partir d’une courte vidéo de référence d’un animal, d’une mascotte ou d’un objet. Ses consignes de préparation prévoient un clip MP4 d’environ deux à quatre secondes, de 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre le rapport largeur/hauteur de la source à celui de la sortie permet d’éviter un aspect étiré. La génération peut faire référence à deux personnages au maximum.
Conservez l’identifiant du personnage et mentionnez son nom dans le prompt ; transmettre uniquement l’identifiant ne constitue pas la préparation complète décrite par le guide. Les ressources de personnages peuvent accompagner une génération guidée par une image, mais les prolongements vidéo ne les acceptent pas. Le fournisseur bloque par défaut les imports de personnages à apparence humaine et refuse les images de référence contenant des visages humains dans le processus API documenté. Les fonctionnalités de personnages personnels de l’application Sora relèvent d’un processus produit distinct.
Un prolongement utilise une vidéo source terminée et un prompt de continuation, en prenant l’intégralité du clip source comme contexte pour le mouvement, la direction de caméra et la continuité de la scène. Le guide décrit des ajouts allant jusqu’à 20 secondes par prolongement. L’entrée documentée pour un prolongement comprend la vidéo source et le texte ; les références supplémentaires de personnages ou d’images sont exclues de ce mode. Décrivez comment l’action existante se poursuit au lieu d’introduire une scène sans rapport et sans transition.
La retouche vidéo vise une modification claire d’un clip existant. Une révision ciblée peut changer la couleur d’un objet ou la palette de la scène tout en conservant le reste du plan. Le guide du fournisseur recommande une seule modification bien définie à la fois et distingue la retouche d’une vidéo générée de l’import de séquences quelconques, soumis à une condition d’éligibilité distincte. Conservez la source terminée et indiquez précisément la révision attendue avant de procéder à une nouvelle retouche.
Le processus vidéo documenté du fournisseur est asynchrone : une tâche soumise peut être en file d’attente ou en cours avant de se terminer ou d’échouer. Une tâche terminée fournit une vidéo MP4 ; les vignettes et les planches de sprites servent à la prévisualisation et à la navigation. Conservez l’identité de la tâche avec le prompt, les références et les ressources renvoyées. La réponse initiale à la soumission d’une tâche n’est pas la vidéo finale lisible.
Le processus de téléchargement ordinaire indique une durée de validité d’une heure pour l’URL de téléchargement. Le processus par lots étendu prépare des requêtes de rendu JSON indépendantes, avec des identifiants d’éléments stables, des références importées et un résultat associé à chaque plan ; ses ressources terminées disposent d’une période de téléchargement distincte pouvant atteindre 24 heures. Enregistrez rapidement le clip terminé et examinez l’image et le son réels avant de le considérer comme une prise retenue.
Les restrictions de contenu documentées pour l’API du fournisseur exigent des contenus adaptés aux moins de 18 ans et refusent les personnages ou la musique protégés par le droit d’auteur ainsi que la génération de personnes réelles. Préparez la scène et les références en conséquence. Le résultat direct du modèle est une vidéo avec audio, et non des images fixes générées, une réponse conversationnelle d’outil ou un film de durée illimitée. Conservez l’identité exacte du modèle standard et le clip source accepté lorsque vous poursuivez un concept visuel.
POST /v1/chat/completionstextjson, sse| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites sora-2 | Par défaut— |
Champmessages | Typemessage[] | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmessages[].role | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmessages[].content | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
owned_text_messages
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, messages |
Paramètrematerial_types | Contrattext |
Paramètremessages | Contrattableau de messages avec role et content sous forme de chaîne littérale |
Paramètrefile_material | ContratLe contenu UTF-8 réel peut être inséré comme contenu de chaîne littérale ; aucune référence à un fichier n’en est déduite. |
Paramètreoptional_controls | Contratstream |
Cycle de vie : synchronous_json_or_sse
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Coût Entrée · Tokens en entrée $0 / 1K tokens Sortie · Tokens en sortie $0.2 / 1K tokens Entrée · Lecture du cache $0 / 1K tokens Entrée · Écriture dans le cache $0 / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":false}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nfrom pathlib import Path\nprint(Path("result.json").read_text(encoding="utf-8"))\nPY_RESULT\nfrom openai import OpenAI\nimport os\n\nif not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")\nclient=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)\nresult=client.chat.completions.create(model="sora-2", messages=[{"role":"user","content":"hello"}], stream=False)\nimport json\nfrom pathlib import Path\n\ndata = result.to_dict(mode="json")\nPath("result.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")\nprint(json.dumps(data, ensure_ascii=False, indent=2))\nset -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":true}')\n\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.sse\nJSON ou text/event-stream
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez l’intégralité des octets JSON ou SSE, les en-têtes de réponse, la consommation renvoyée et tous les champs de résultat fournis. Aucune famille de résultats propre au modèle n’est affirmée.
Conservez la réponse d’origine et l’identité de la tentative ; aucune nouvelle interrogation de tâche ni nouvelle soumission n’en est déduite.
| Champ | Type | Signification |
|---|---|---|
Champcomplete response JSON | Typeobject | SignificationConservez chaque champ renvoyé sans présumer d’une famille de résultats propre au modèle. |
ChampSSE data events | Typestream | SignificationConservez chaque événement renvoyé et chaque marqueur terminal sans sélectionner uniquement les champs de texte. |
Ailoot Ultra sora-2
Utilisez les chemins de méthode indiqués ci-dessus.
sora-2Sora 2 crée des vidéos avec dialogues, effets sonores et ambiance audio synchronisés à partir d’un texte ou d’une image de référence. Le profil standard permet l’exploration visuelle et la création de clips conceptuels ; le fournisseur propose des processus distincts pour les personnages non humains réutilisables, les prolongements et les retouches vidéo ciblées.
Cette description présente les capacités du modèle. Les entrées, sorties et options disponibles dans Ailoot pour la méthode sélectionnée figurent ci-dessous.
Sora 2 est le modèle de génération vidéo et audio d’OpenAI pour des clips dynamiques créés à partir d’une description écrite de scène ou d’une image de référence. Il génère la séquence visuelle avec des paroles, des effets et une ambiance sonore synchronisés. Le profil Sora 2 standard est destiné à l’exploration visuelle, au développement de concepts, aux prototypes et aux premiers montages. Sora 2 Pro est une édition distincte visant une fidélité visuelle accrue et une finition en plus haute résolution.
Le guide de prompting du concepteur organise un brief utile autour du cadrage, du sujet, de l’action, du décor et de la lumière. Donnez à la scène un style visuel cohérent, puis décrivez le mouvement en temps clairement définis. Un concept de produit original pourrait montrer un petit objet mécanique faisant un tour sur un établi tandis que la caméra s’approche lentement, avec une douce lumière de fenêtre et un léger bruit de moteur. Précisez ce que le spectateur doit remarquer et comment l’action se termine.
Rendez compréhensibles le mouvement de caméra et l’action du sujet dans chaque plan. Une séquence complexe peut être divisée en blocs de plans distincts, chacun avec son cadrage, son action et son éclairage. Conservez les mêmes détails du sujet et la même palette lorsque plusieurs clips doivent former une seule séquence. Le guide souligne que les plans courts suivent généralement les consignes de façon plus fiable et que des générations répétées à partir du même prompt produisent des prises différentes.
La présentation de lancement du modèle décrit un meilleur comportement physique et une meilleure continuité entre les plans, notamment dans les styles réaliste, cinématographique et anime. Il s’agit de capacités à diriger et à examiner. Vérifiez le mouvement, le contact entre les objets, les proportions et la continuité, sans supposer qu’une première image plausible garantit une séquence cohérente. Si une action manque de clarté, simplifiez-la et donnez-lui un début et une fin visibles.
Précisez les répliques séparément de la description visuelle et identifiez les locuteurs de façon constante. Gardez des dialogues assez courts pour correspondre à l’action et à la durée prévue du clip. Pour une animation à deux personnages, alternez une brève question et sa réponse plutôt que d’imposer un long discours à un plan court. Le guide avertit que des dialogues longs et complexes peuvent perturber le rythme et la synchronisation.
Décrivez l’environnement sonore propre à la scène : le son d’un petit mouvement, l’ambiance d’une pièce ou le rythme d’un effet environnemental. Expliquez quel son doit coïncider avec l’action. Écoutez les paroles et les effets obtenus en regardant l’image, et vérifiez l’attribution des voix, les mots et le timing. L’audio synchronisé fait partie du clip généré ; il ne s’agit pas d’une réponse textuelle séparée.
Les dimensions de sortie documentées pour le modèle standard sont 720×1280 en portrait et 1280×720 en paysage. Les dimensions de plus haute résolution du profil Pro ne doivent pas être attribuées à Sora 2 standard. Les dimensions et la durée sont des paramètres explicites de la requête ; écrire une autre taille ou demander un film plus long dans le prompt ne modifie pas ces paramètres. La référence de création indique des durées de clip de 4, 8 et 12 secondes : préparez donc un temps d’action court et défini pour chaque plan. Le processus étendu du fournisseur documente également des durées de 16 et 20 secondes.
Une image de référence ancre la première image de la vidéo et le texte décrit ce qui se passe ensuite. Le fournisseur accepte les références JPEG, PNG et WebP et exige que l’image corresponde aux dimensions de la vidéo cible. Préparez le sujet, l’environnement et la composition dans cette image d’ouverture, puis demandez un mouvement précis. Cette référence définit la première image ; elle ne garantit pas que chaque détail restera identique tout au long du clip.
Le processus étendu du fournisseur permet de créer une ressource de personnage réutilisable à partir d’une courte vidéo de référence d’un animal, d’une mascotte ou d’un objet. Ses consignes de préparation prévoient un clip MP4 d’environ deux à quatre secondes, de 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre le rapport largeur/hauteur de la source à celui de la sortie permet d’éviter un aspect étiré. La génération peut faire référence à deux personnages au maximum.
Conservez l’identifiant du personnage et mentionnez son nom dans le prompt ; transmettre uniquement l’identifiant ne constitue pas la préparation complète décrite par le guide. Les ressources de personnages peuvent accompagner une génération guidée par une image, mais les prolongements vidéo ne les acceptent pas. Le fournisseur bloque par défaut les imports de personnages à apparence humaine et refuse les images de référence contenant des visages humains dans le processus API documenté. Les fonctionnalités de personnages personnels de l’application Sora relèvent d’un processus produit distinct.
Un prolongement utilise une vidéo source terminée et un prompt de continuation, en prenant l’intégralité du clip source comme contexte pour le mouvement, la direction de caméra et la continuité de la scène. Le guide décrit des ajouts allant jusqu’à 20 secondes par prolongement. L’entrée documentée pour un prolongement comprend la vidéo source et le texte ; les références supplémentaires de personnages ou d’images sont exclues de ce mode. Décrivez comment l’action existante se poursuit au lieu d’introduire une scène sans rapport et sans transition.
La retouche vidéo vise une modification claire d’un clip existant. Une révision ciblée peut changer la couleur d’un objet ou la palette de la scène tout en conservant le reste du plan. Le guide du fournisseur recommande une seule modification bien définie à la fois et distingue la retouche d’une vidéo générée de l’import de séquences quelconques, soumis à une condition d’éligibilité distincte. Conservez la source terminée et indiquez précisément la révision attendue avant de procéder à une nouvelle retouche.
Le processus vidéo documenté du fournisseur est asynchrone : une tâche soumise peut être en file d’attente ou en cours avant de se terminer ou d’échouer. Une tâche terminée fournit une vidéo MP4 ; les vignettes et les planches de sprites servent à la prévisualisation et à la navigation. Conservez l’identité de la tâche avec le prompt, les références et les ressources renvoyées. La réponse initiale à la soumission d’une tâche n’est pas la vidéo finale lisible.
Le processus de téléchargement ordinaire indique une durée de validité d’une heure pour l’URL de téléchargement. Le processus par lots étendu prépare des requêtes de rendu JSON indépendantes, avec des identifiants d’éléments stables, des références importées et un résultat associé à chaque plan ; ses ressources terminées disposent d’une période de téléchargement distincte pouvant atteindre 24 heures. Enregistrez rapidement le clip terminé et examinez l’image et le son réels avant de le considérer comme une prise retenue.
Les restrictions de contenu documentées pour l’API du fournisseur exigent des contenus adaptés aux moins de 18 ans et refusent les personnages ou la musique protégés par le droit d’auteur ainsi que la génération de personnes réelles. Préparez la scène et les références en conséquence. Le résultat direct du modèle est une vidéo avec audio, et non des images fixes générées, une réponse conversationnelle d’outil ou un film de durée illimitée. Conservez l’identité exacte du modèle standard et le clip source accepté lorsque vous poursuivez un concept visuel.
POST /v1/messagestextjson, sse| Champ | Type | Exigence | Valeurs et limites | Par défaut |
|---|---|---|---|---|
Champmodel | Typestring | ExigenceObligatoire | Valeurs et limites sora-2 | Par défaut— |
Champmessages | Typemessage[] | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmessages[].role | Typestring | ExigenceObligatoire | Valeurs et limites user, assistant | Par défaut— |
Champmessages[].content | Typestring | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champmax_tokens | Typeinteger | ExigenceObligatoire | Valeurs et limites | Par défaut— |
Champstream | Typeboolean | ExigenceFacultatif | Valeurs et limites | Par défautfalse |
Texte · Texte UTF-8
chaîne messages[].content
| Paramètre | Contrat |
|---|---|
Paramètrecontent_type | Contratapplication/json |
Paramètrerequired | Contratmodel, messages, max_tokens |
Paramètreoptional_controls | Contratstream |
Paramètrematerial_types | Contrattext |
Paramètretext_file_material | ContratLisez le document UTF-8 réel et placez son texte dans l’entrée indiquée ou dans la chaîne de contenu du message. |
Cycle de vie : synchronous_or_streamed
Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.
| Configuration | Barème tarifaire | Coût |
|---|---|---|
| ConfigurationTarifs de base des tokens | Barème tarifaireTarif de base | Coût Entrée · Tokens en entrée $0 / 1K tokens Sortie · Tokens en sortie $0.2 / 1K tokens Entrée · Lecture du cache $0 / 1K tokens Entrée · Écriture dans le cache $0 / 1K tokens Entrée · Écriture dans le cache, 1 h — / 1K tokens |
Ailoot réserve un montant estimé avant une requête. Après le résultat, le montant final est débité selon l’utilisation mesurée. Pour le streaming, le montant final à débiter est calculé à partir du relevé final d’utilisation. Fonctionnement de la réservation et du débit →
{\n "model": "sora-2",\n "max_tokens": 128,\n "messages": [\n {\n "role": "user",\n "content": "Summarize the incident report."\n }\n ],\n "stream": false\n}set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"\nexport AILOOT_TEXT_FILE\npython3 - <<'PY_REQUEST'\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nPath('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \\\n -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\npython3 - <<'PY_RESULT'\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nPY_RESULT\nimport json, os\nfrom pathlib import Path\n\nsource_file = Path(os.environ['AILOOT_TEXT_FILE'])\nif not source_file.is_file():\n raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')\ntext = source_file.read_text(encoding='utf-8')\nif not text.strip():\n raise SystemExit('Choose a document containing text')\npayload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}\npayload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\\n\\n' + text\nfrom urllib.request import Request, urlopen\nfrom urllib.error import HTTPError\n\napi_key = os.environ['AILOOT_API_KEY']\nif not api_key.strip():\n raise SystemExit('Set AILOOT_API_KEY before making a request')\nheaders = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}\nheaders['x-api-key'] = api_key\nrequest = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')\ntry:\n with urlopen(request, timeout=120) as response:\n raw = response.read()\n Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')\nexcept HTTPError as error:\n Path('result.json').write_bytes(error.read())\n Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')\n raise\nPath('result.json').write_bytes(raw)\nimport json\nfrom pathlib import Path\n\nresult = json.loads(Path('result.json').read_text(encoding='utf-8'))\nprint(json.dumps(result, ensure_ascii=False, indent=2))\nJSON ou SSE
Conservez chaque réponse, fichier et partie de contenu renvoyés dans leur intégralité.
Conservez tous les blocs de contenu, les signatures de raisonnement et les identifiants réels d’utilisation d’outils. Assemblez tous les deltas de blocs SSE ; un premier bloc de texte ne constitue pas la sortie complète.
Conservez les identifiants de requête et de réponse ainsi que les en-têtes. Aucune URL générique de récupération des tâches textuelles n’est fournie.
| Champ | Type |
|---|---|
Champid | Typestring |
Champmodel | Typestring |
Champcontent[] | Typetext|thinking|tool_use|other content block |
Champstop_reason | Typestring|null |
Champusage | Typeobject |
| Réponse | Condition | Étape suivante |
|---|---|---|
Réponse400 · invalid_request_error | ConditionChamps obligatoires, représentation des contenus ou valeur de paramètre non valides | Étape suivanteCorrigez les champs indiqués avant une nouvelle requête de création. |
Ailoot Ultra sora-2
Utilisez les chemins de méthode indiqués ci-dessus.