sora-2

Sora 2 crée des vidéos avec des dialogues, des effets sonores et une ambiance audio synchronisés à partir d’un texte ou d’une image de référence. Le profil standard sert à l’exploration visuelle et aux clips conceptuels, avec des processus distincts du producteur pour les personnages non humains réutilisables, la prolongation et les modifications vidéo ciblées.

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

À 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 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 la parole, les effets et les sons d’ambiance synchronisés. Le profil standard Sora 2 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 meilleure fidélité visuelle 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 tandis que la caméra s’approche lentement, avec une lumière douce venant d’une fenêtre et un léger bruit de moteur. Précisez ce que le spectateur doit remarquer et comment l’action se termine.

Veillez à ce que le mouvement de caméra et l’action du sujet restent compréhensibles 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 instructions plus fidèlement et que des générations répétées à partir du même prompt produisent des prises différentes.

La présentation du modèle à son lancement décrit une amélioration du comportement physique et de la continuité entre les plans, notamment pour les styles réaliste, cinématographique et anime. Ce sont des capacités annoncées qu’il faut diriger et examiner. Vérifiez le mouvement, les contacts entre 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 le son

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

Décrivez l’univers sonore de la scène : le son d’un petit mouvement, l’ambiance d’une pièce ou le rythme d’un effet environnemental. Indiquez quel son doit coïncider avec l’action. Écoutez la parole et les effets obtenus en regardant l’image, et vérifiez l’attribution des voix, les mots et le minutage. 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 ouverture guidée 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 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 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 propose des clips de 4, 8 et 12 secondes : choisissez donc une action courte et définie lorsque vous préparez un plan. Le processus étendu du producteur documente également des réglages 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 producteur 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. Il s’agit d’une référence pour l’image initiale, et non d’une garantie que chaque détail restera identique pendant tout le clip.

Personnages non humains réutilisables

Le processus étendu du producteur peut créer un élément de personnage réutilisable à partir d’une courte vidéo de référence montrant un animal, une mascotte ou un objet. Ses consignes de préparation demandent un clip MP4 d’environ deux à quatre secondes, de 720p à 1080p, au format 16:9 ou 9:16. Faire correspondre les proportions de la source et de la sortie aide à éviter un aspect étiré. La génération peut référencer jusqu’à deux personnages.

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 éléments de personnage peuvent accompagner une génération guidée par une image, mais les prolongations vidéo ne les acceptent pas. Le producteur 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 parcours API documenté. Les fonctions de personnages personnels de l’application Sora relèvent d’un processus produit distinct.

Prolonger ou modifier un clip terminé

Une prolongation reçoit une vidéo source terminée et un prompt de continuation, et utilise le clip source complet comme contexte pour le mouvement, la direction de caméra et la continuité de la scène. Le guide décrit des ajouts pouvant atteindre 20 secondes par prolongation. Les entrées documentées de ce mode sont 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 sans transition une scène sans rapport.

La modification vidéo vise un changement clair dans un clip existant. Une révision ciblée peut modifier la couleur d’un objet ou la palette de la scène tout en conservant le reste du plan. Le guide du producteur recommande un changement bien défini à la fois et distingue la modification d’une vidéo générée du téléversement de séquences quelconques, soumis à une condition d’éligibilité distincte. Conservez la source terminée et définissez la révision exacte nécessaire avant d’effectuer une autre modification.

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

Le parcours vidéo documenté du producteur est asynchrone : une tâche envoyée peut être en file d’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 vignettes facilitent l’aperçu et la navigation. Gardez l’identité de la tâche associée au prompt, aux références et aux fichiers retournés. La réponse initiale à une tâche n’est pas la vidéo finale prête à être lue.

Le parcours de téléchargement ordinaire indique une validité d’une heure pour l’URL de téléchargement. Le processus é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 associé à chaque plan ; ses fichiers terminés disposent d’une période de téléchargement distincte allant jusqu’à 24 heures. Enregistrez rapidement le clip terminé et examinez l’image et le son réels avant de le considérer comme une prise sélectionnée.

Les restrictions de contenu documentées de l’API du producteur exigent un contenu adapté aux moins de 18 ans et refusent 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, et non des images fixes générées, une réponse d’outil conversationnel 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

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

Entrée: text
Sortie: json, sse
Format de sortie: JSON ou text/event-stream

Champ	Type	Exigence	Valeurs et limites	Par défaut
Champ`model`	Type`string`	ExigenceObligatoire	Valeurs et limites sora-2	Par défaut—
Champ`messages`	Type`message[]`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`messages[].role`	Type`string`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`messages[].content`	Type`string`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`stream`	Type`boolean`	ExigenceFacultatif	Valeurs et limites	Par défautfalse

Combinaisons d’éléments d’entrée

owned_text_messages

Paramètres et cycle de vie de la méthode

Paramètre	Contrat
Paramètre`content_type`	Contratapplication/json
Paramètre`required`	Contratmodel, messages
Paramètre`material_types`	Contrattext
Paramètre`messages`	Contrattableau de messages avec un champ role et un champ content contenant une chaîne littérale
Paramètre`file_material`	ContratLe contenu UTF-8 réel peut être inséré comme texte littéral d’une chaîne ; aucune référence à un fichier n’est déduite.
Paramètre`optional_controls`	Contratstream

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

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 →

Exemples de requêtes

Ailoot Ultra · Chat Completions

curl · réponse JSON complètePython SDK · réponse JSON complètecurl · conservez 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, 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.

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

Conservez la réponse d’origine et l’identité de la tentative ; aucune nouvelle consultation périodique de tâche ni aucun renvoi de demande n’est déduit.

Champs de la réponse

Champ	Type	Signification
Champ`complete response JSON`	Typeobject	SignificationConservez chaque champ renvoyé sans présumer d’une famille de résultats propre au modèle.
Champ`SSE data events`	Typestream	SignificationConservez chaque événement renvoyé et chaque marqueur de fin 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 · Anthropic Messages POST /v1/messages sora-2

sora-2

Autre /sora-2

Premiers pas

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

Disponible dans Ailoot · entrées et méthodes

Ailoot Ultra · Anthropic Messages POST /v1/messages

Entrée: text
Sortie: json, sse
Format de sortie: JSON ou SSE

Champ	Type	Exigence	Valeurs et limites	Par défaut
Champ`model`	Type`string`	ExigenceObligatoire	Valeurs et limites sora-2	Par défaut—
Champ`messages`	Type`message[]`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`messages[].role`	Type`string`	ExigenceObligatoire	Valeurs et limites user, assistant	Par défaut—
Champ`messages[].content`	Type`string`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`max_tokens`	Type`integer`	ExigenceObligatoire	Valeurs et limites	Par défaut—
Champ`stream`	Type`boolean`	ExigenceFacultatif	Valeurs et limites	Par 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ètre	Contrat
Paramètre`content_type`	Contratapplication/json
Paramètre`required`	Contratmodel, messages, max_tokens
Paramètre`optional_controls`	Contratstream
Paramètre`material_types`	Contrattext
Paramètre`text_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

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

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

Exemples de requêtes

Ailoot Ultra · Anthropic Messages

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 · Anthropic Messages

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

Champ	Type
Champ`id`	Typestring
Champ`model`	Typestring
Champ`content[]`	Typetext\|thinking\|tool_use\|other content block
Champ`stop_reason`	Typestring\|null
Champ`usage`	Typeobject

Erreurs et étapes suivantes

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.

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

sora-2

sora-2

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

Diriger séparément les dialogues et le son

Dimensions, durée et ouverture guidée par une image

Personnages non humains réutilisables

Prolonger ou modifier un clip terminé

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

Premiers pas

Disponible dans Ailoot · entrées et méthodes

Tarifs

Tarifs Ailoot

Prix par configuration

Exemples de requêtes

Ailoot Ultra · Chat Completions

Recevoir et enregistrer les résultats

Ailoot Ultra · Chat Completions

Conserver tous les résultats terminés

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

Alias

Alias du modèle

Alias des chemins de méthode

ID d’appel associés

Premiers pas

Disponible dans Ailoot · entrées et méthodes

Tarifs

Tarifs Ailoot

Prix par configuration

Exemples de requêtes

Ailoot Ultra · Anthropic Messages

Recevoir et enregistrer les résultats

Ailoot Ultra · Anthropic Messages

Conserver tous les résultats terminés

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

Alias

Alias du modèle

Alias des chemins de méthode

ID d’appel associés

L’entreprise et son portefeuille de projets

Achetez des tokens à prix réduit.

Connectez l’API au produit que vous vendez.