modèles

sora-2

Markdown · JSON

sora-2

Sora 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 workflows distincts pour les personnages non humains réutilisables, les prolongements et les retouches vidéo ciblées.

À propos du modèle

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 créer des clips dynamiques à partir d’une description de scène écrite ou d’une image de référence. Il génère la séquence visuelle avec des paroles, des effets et des sons d’ambiance synchronisés. Le profil standard Sora 2 est destiné à l’exploration visuelle, au développement de concepts, aux prototypes et aux premières versions de montage. Sora 2 Pro est une édition distincte, visant une fidélité visuelle accrue et une finition à plus haute résolution.

Décrire un plan que l’on peut voir et entendre

Le guide de prompting du fabricant 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 étapes claires. Un concept de produit original pourrait montrer un petit objet mécanique effectuant un tour sur un établi pendant 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 séquence. Le guide souligne que les plans courts suivent généralement les consignes plus fidèlement et que des générations répétées avec le même prompt produisent des prises différentes.

La présentation du modèle annonce un comportement physique et une continuité entre les plans améliorés, notamment dans les styles réaliste, cinématographique et anime. Ce sont des 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.

Diriger séparément les dialogues et les sons

Précisez les répliques séparément de la description visuelle et identifiez les locuteurs de manière cohérente. Gardez des dialogues assez courts pour tenir dans l’action et la durée du clip prévue. Pour une animation à deux personnages, alternez une brève question et sa réponse plutôt que de demander à un plan court d’accueillir un long discours. Le guide avertit que des dialogues longs et complexes peuvent perturber le rythme et la synchronisation.

Décrivez le paysage 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 avec l’image, en vérifiant 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.

Dimensions, durée et début guidé par une image

Les dimensions de sortie documentées du modèle standard sont 720×1280 en portrait et 1280×720 en paysage. Les dimensions à 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 d’autres dimensions 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 4, 8 et 12 secondes : préparez donc un temps d’action court et défini pour chaque plan. Le workflow étendu du fournisseur documente également des durées de 16 et 20 secondes.

Une image de référence fixe le point de départ de la première image, et le texte décrit la suite. Le fournisseur accepte les références JPEG, PNG et WebP et exige que leurs dimensions correspondent à celles de la vidéo cible. Préparez le sujet, l’environnement et la composition dans cette image initiale, puis demandez un mouvement précis. Cette référence guide l’image de départ sans garantir la reproduction de chaque détail pendant tout le clip.

Personnages non humains réutilisables

Le workflow étendu du fournisseur peut créer un 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éconisent un clip MP4 d’environ deux à quatre secondes, en 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre les rapports d’aspect de la source et de la sortie aide à éviter un rendu é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 personnage 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 téléversements de personnages ressemblant à des humains et rejette les images de référence contenant des visages humains dans le flux API documenté. Les fonctions de personnages personnels de l’application Sora relèvent d’un workflow produit distinct.

Prolonger ou modifier un clip terminé

Un prolongement utilise une vidéo source terminée et un prompt de continuation, en prenant le clip source entier 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 de ce mode comprend la vidéo source et le texte ; les références supplémentaires de personnages ou d’images en sont exclues. 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 modification bien définie à la fois et distingue la retouche d’une vidéo générée du téléversement d’une vidéo quelconque, soumis à une condition d’éligibilité distincte. Conservez la source terminée et identifiez précisément la révision attendue avant d’effectuer une autre retouche.

Tâches de rendu et vidéo terminée

Le flux vidéo documenté du fournisseur est asynchrone : une tâche soumise peut être en attente ou en cours avant de se terminer ou d’échouer. Une tâche terminée produit une vidéo MP4 ; des miniatures et des planches de sprites facilitent les aperçus 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 à une tâche n’est pas la vidéo finale lisible.

Le workflow de téléchargement ordinaire indique une durée de validité d’une heure pour l’URL de téléchargement. Le workflow étendu par lots prépare des requêtes de rendu JSON indépendantes, avec des identifiants d’éléments stables, des références téléversées et un résultat rattaché à chaque plan ; ses ressources terminées disposent d’une période de téléchargement distincte allant jusqu’à 24 heures. Sauvegardez rapidement le clip terminé et examinez l’image et le son réels avant de le retenir comme prise sélectionnée.

Les restrictions de contenu documentées de l’API du fournisseur exigent des contenus adaptés aux moins de 18 ans et rejettent les personnages ou musiques 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, pas 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.

Ailoot Ultra · Chat Completions POST /v1/chat/completions sora-2

sora-2

Autre /sora-2

Premiers pas

Sora 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 workflows distincts pour les personnages non humains réutilisables, les prolongements et les retouches vidéo ciblées.

Entrées acceptées
Texte
Résultats
json · sse

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Chat Completions POST /v1/chat/completions
Types d’entrée
text
Types de sortie
json, sse
Format de sortie
JSON ou text/event-stream
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
sora-2
Par défaut—
ChampmessagesTypemessage[]ExigenceObligatoireValeurs et limitesPar défaut—
Champmessages[].roleTypestringExigenceObligatoireValeurs et limitesPar défaut—
Champmessages[].contentTypestringExigenceObligatoireValeurs et limitesPar défaut—
ChampstreamTypebooleanExigenceFacultatifValeurs et limitesPar défautfalse
Combinaisons d’éléments d’entrée

owned_text_messages

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, messages
Paramètrematerial_typesContrattext
ParamètremessagesContrattableau de messages avec role et content sous forme de chaîne littérale
Paramètrefile_materialContratLe contenu UTF-8 réel peut être inséré comme chaîne textuelle littérale ; aucune référence de fichier n’est déduite.
Paramètreoptional_controlsContratstream

Cycle de vie : synchronous_json_or_sse

Tarifs

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs Ailoot

Prix par configuration

ConfigurationBarème tarifaireCoût
ConfigurationTarifs de base des tokensBarème tarifaireTarif de baseCoû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 →

Exemples de requêtes

Ailoot Ultra · Chat Completions

curl · réponse JSON complètePython SDK · réponse JSON complètecurl · conserver le flux SSE
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":false}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
from pathlib import Path
print(Path("result.json").read_text(encoding="utf-8"))
PY_RESULT
from openai import OpenAI
import os

if not os.environ.get("AILOOT_API_KEY", "").strip(): raise SystemExit("Set AILOOT_API_KEY before making a request")
client=OpenAI(base_url="https://api.ailoot.ai/v1",api_key=os.environ["AILOOT_API_KEY"],max_retries=0)
result=client.chat.completions.create(model="sora-2", messages=[{"role":"user","content":"hello"}], stream=False)
import json
from pathlib import Path

data = result.to_dict(mode="json")
Path("result.json").write_text(json.dumps(data, ensure_ascii=False, indent=2), encoding="utf-8")
print(json.dumps(data, ensure_ascii=False, indent=2))
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model":"sora-2","messages":[{"role":"user","content":"hello"}],"stream":true}')

Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/chat/completions \
  -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.sse

Recevoir et enregistrer les résultats

Ailoot Ultra · Chat Completions

JSON ou text/event-stream

Conserver tous les résultats terminés

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, l’utilisation renvoyée et tous les champs de résultat fournis. Aucune famille de sorties propre au modèle n’est affirmée.

Si la réponse d’origine doit être vérifiée

Conservez la réponse d’origine et l’identité de la tentative ; aucun nouveau suivi de tâche ni aucune nouvelle soumission n’en est déduit.

Champs de la réponse
ChampTypeSignification
Champcomplete response JSONTypeobjectSignificationConservez chaque champ renvoyé sans supposer une famille de résultats propre au modèle.
ChampSSE data eventsTypestreamSignificationConservez chaque événement renvoyé et chaque marqueur terminal, sans sélectionner uniquement les champs texte.

Alias

Alias du modèle

Ailoot Ultra sora-2

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

sora-2

Ailoot Ultra · Messages Anthropic POST /v1/messages sora-2

sora-2

Autre /sora-2

Premiers pas

Sora 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 workflows distincts pour les personnages non humains réutilisables, les prolongements et les retouches vidéo ciblées.

Entrées acceptées
Texte
Résultats
json · sse

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Messages Anthropic POST /v1/messages
Types d’entrée
text
Types de sortie
json, sse
Format de sortie
JSON ou SSE
ChampTypeExigenceValeurs et limitesPar défaut
ChampmodelTypestringExigenceObligatoireValeurs et limites
sora-2
Par défaut—
ChampmessagesTypemessage[]ExigenceObligatoireValeurs et limitesPar défaut—
Champmessages[].roleTypestringExigenceObligatoireValeurs et limites
user, assistant
Par défaut—
Champmessages[].contentTypestringExigenceObligatoireValeurs et limitesPar défaut—
Champmax_tokensTypeintegerExigenceObligatoireValeurs et limitesPar défaut—
ChampstreamTypebooleanExigenceFacultatifValeurs et limitesPar défautfalse
Combinaisons d’éléments d’entrée

Texte · Texte UTF-8

chaîne messages[].content

Paramètres et cycle de vie de la méthode
ParamètreContrat
Paramètrecontent_typeContratapplication/json
ParamètrerequiredContratmodel, messages, max_tokens
Paramètreoptional_controlsContratstream
Paramètrematerial_typesContrattext
Paramètretext_file_materialContratLisez 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

Tarifs

Les tarifs n’ajoutent pas d’options de requête. Les paramètres pris en charge figurent dans la méthode sélectionnée.

Mode rapide
Non précisé Lorsque le mode rapide est sélectionné
Mode Flex
Non précisé Lorsque le mode flex est sélectionné
Effort de raisonnement maximal
Non précisé Lorsque l’effort de raisonnement maximal utilise l’ajustement par défaut (default)

Tarifs Ailoot

Prix par configuration

ConfigurationBarème tarifaireCoût
ConfigurationTarifs de base des tokensBarème tarifaireTarif de baseCoû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 →

Exemples de requêtes

Ailoot Ultra · Messages Anthropic

Corps JSON minimal completcurl · utilisez votre document UTF-8Python · enregistrez le résultat complet
{
  "model": "sora-2",
  "max_tokens": 128,
  "messages": [
    {
      "role": "user",
      "content": "Summarize the incident report."
    }
  ],
  "stream": false
}
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_TEXT_FILE:?Set your actual UTF-8 document}"
export AILOOT_TEXT_FILE
python3 - <<'PY_REQUEST'
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
Path('request.json').write_text(json.dumps(payload, ensure_ascii=False), encoding='utf-8')
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/messages \
  -H "x-api-key: $AILOOT_API_KEY" -H 'anthropic-version: 2023-06-01' -H 'Content-Type: application/json' \
  --data-binary @request.json -D response-headers.txt -o result.json
python3 - <<'PY_RESULT'
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))
PY_RESULT
import json, os
from pathlib import Path

source_file = Path(os.environ['AILOOT_TEXT_FILE'])
if not source_file.is_file():
    raise SystemExit('Set AILOOT_TEXT_FILE to your actual UTF-8 document')
text = source_file.read_text(encoding='utf-8')
if not text.strip():
    raise SystemExit('Choose a document containing text')
payload = {'model': 'sora-2', 'max_tokens': 128, 'messages': [{'role': 'user', 'content': 'Summarize the incident report.'}]}
payload['messages'][0]['content'] = 'Summarize this material and quote supporting source passages.\n\n' + text
from urllib.request import Request, urlopen
from urllib.error import HTTPError

api_key = os.environ['AILOOT_API_KEY']
if not api_key.strip():
    raise SystemExit('Set AILOOT_API_KEY before making a request')
headers = {'x-api-key': 'PLACEHOLDER_KEY', 'anthropic-version': '2023-06-01', 'Content-Type': 'application/json'}
headers['x-api-key'] = api_key
request = Request('https://api.ailoot.ai/v1/messages', data=json.dumps(payload, ensure_ascii=False).encode('utf-8'), headers=headers, method='POST')
try:
    with urlopen(request, timeout=120) as response:
        raw = response.read()
        Path('response-headers.txt').write_text(str(response.headers), encoding='utf-8')
except HTTPError as error:
    Path('result.json').write_bytes(error.read())
    Path('response-headers.txt').write_text(str(error.headers), encoding='utf-8')
    raise
Path('result.json').write_bytes(raw)
import json
from pathlib import Path

result = json.loads(Path('result.json').read_text(encoding='utf-8'))
print(json.dumps(result, ensure_ascii=False, indent=2))

Recevoir et enregistrer les résultats

Ailoot Ultra · Messages Anthropic

JSON ou SSE

Conserver tous les résultats terminés

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.

Si la réponse d’origine doit être vérifiée

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.

Champs de la réponse
ChampType
ChampidTypestring
ChampmodelTypestring
Champcontent[]Typetext|thinking|tool_use|other content block
Champstop_reasonTypestring|null
ChampusageTypeobject
Erreurs et étapes suivantes
RéponseConditionÉtape suivante
Réponse400 · invalid_request_errorConditionChamps 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.

Alias

Alias du modèle

Ailoot Ultra sora-2

Alias des chemins de méthode

Utilisez les chemins de méthode indiqués ci-dessus.

ID d’appel associés

sora-2

FAQ · sora-2
Quelles entrées et quels résultats sont disponibles ?

POST /v1/chat/completions · sora-2: text → json, sse

POST /v1/messages · sora-2: text → json, sse

Quels champs la requête utilise-t-elle ?

POST /v1/chat/completions · sora-2: model, messages, stream

POST /v1/messages · sora-2: model, messages, max_tokens, stream

Plus de détails

Connectez Ailoot à Claude Code, OpenCode, Hermes ou à votre application.

L’entreprise et son portefeuille de projets

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Achetez des tokens à prix réduit.

Une remise d’abonnement pour le travail régulier. Des codes promo jusqu’à 50% sur l’achat de tokens.

Abonnement
Choisissez une offre à tarif réduit pour vos requêtes régulières.
Code promo jusqu’à 50%
Saisissez le code à l’achat. Le prix est recalculé selon la promotion en cours.
Dépenses dans l’historique
Modèle, tokens et montant sont enregistrés pour chaque requête.

Choisir un abonnement · Voir les prix des modèles

Connectez l’API au produit que vous vendez.

SaaS, applications et bots selon l’offre officielle et le contrat de licence Ailoot. Pour la revente, demandez une licence revendeur.

Application commerciale
Intégrez la génération de texte, d’images, de vidéo et de son aux fonctions payantes de votre service.
Licence revendeur
Envoyez la description du projet et le mode d’accès. Demandez des conditions écrites d’utilisation et de revente.
Documents sur le site
L’offre officielle, le contrat de licence et la politique de traitement des données sont accessibles avant connexion.

Demander une licence revendeur · Offre officielle et contrat de licence