sora-2

Sora 2 skapar video med synkroniserad dialog, ljudeffekter och bakgrundsljud från text eller en referensbild. Standardprofilen stöder visuellt utforskande och konceptklipp, med separata arbetsflöden hos tillverkaren för återanvändbara icke-mänskliga karaktärer, fortsättningar och avgränsade videoredigeringar.

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

Om modellen

Den här beskrivningen omfattar modellens förmågor. Tillgängliga indata, utdata och alternativ i Ailoot anges nedan för den valda metoden.

Sora 2 är OpenAI:s modell för video- och ljudgenerering för dynamiska klipp skapade från en skriftlig scenbeskrivning eller en referensbild. Den genererar bildsekvensen tillsammans med synkroniserat tal, effekter och bakgrundsljud. Standardprofilen Sora 2 är avsedd för visuellt utforskande, konceptutveckling, prototyper och grovklippning. Sora 2 Pro är en separat utgåva inriktad på större visuell detaljtrohet och slutbearbetning i högre upplösning.

Beskriv en tagning som går att se och höra

Tillverkarens promptguide strukturerar en användbar instruktion kring bildutsnitt, motiv, handling, miljö och ljus. Ge scenen en sammanhängande visuell stil och beskriv sedan rörelsen i tydliga moment. Ett eget produktkoncept kan visa ett litet mekaniskt föremål som roterar ett varv på en arbetsbänk medan kameran långsamt närmar sig, med mjukt fönsterljus och ett diskret motorljud. Ange vad tittaren ska lägga märke till och hur handlingen slutar.

Gör varje tagnings kamerarörelse och motivets handling begripliga. En komplicerad sekvens kan delas upp i separata tagningsblock, vart och ett med eget bildutsnitt, egen handling och ljussättning. Bevara samma motivdetaljer och färgpalett när flera klipp ska bilda en sekvens. Guiden betonar att kortare tagningar i allmänhet följer instruktioner mer tillförlitligt och att upprepad generering med samma prompt ger olika tagningar.

Vid modellens lansering beskrivs förbättrat fysiskt beteende och bättre kontinuitet mellan tagningar, bland annat i realistisk, filmisk och anime-inspirerad stil. Det är avsedda förmågor att styra och granska. Granska rörelse, kontakt mellan föremål, proportioner och kontinuitet i stället för att anta att en trovärdig första bildruta garanterar en sammanhängande sekvens. Om en handling är otydlig förenklar du den och ger den en synlig början och ett synligt slut.

Regissera dialog och ljud separat

Ange repliker separat från den visuella beskrivningen och märk talarna konsekvent. Håll dialogen tillräckligt kort för att passa handlingen och klippets avsedda längd. För en animation med två karaktärer kan du växla mellan en kort fråga och ett kort svar i stället för att försöka få in ett långt tal i en kort tagning. Guiden varnar för att komplex och lång dialog kan störa tempo och synkronisering.

Beskriv ljudmiljön som hör till scenen: ljudet från en liten rörelse, rummets bakgrundsljud eller rytmen i en omgivningseffekt. Förklara vilket ljud som ska sammanfalla med handlingen. Lyssna på talet och effekterna tillsammans med bilden och kontrollera rätt talare, ordval och timing. Synkroniserat ljud ingår i det genererade klippet och är inget separat textsvar.

Storlek, längd och en bildstyrd inledning

Standardmodellens dokumenterade utdataformat är 720×1280 stående och 1280×720 liggande. Storlekar med högre upplösning i Pro-profilen ska inte tillskrivas standardversionen av Sora 2. Storlek och längd är uttryckliga inställningar i förfrågan; att skriva en annan storlek eller be om en längre film i prompten ändrar inte dessa inställningar. Referensen för skapande listar klipplängder på 4, 8 och 12 sekunder, så förbered ett kort, definierat moment för tagningen. Det utökade arbetsflödet hos tillverkaren dokumenterar även klipplängder på 16 och 20 sekunder.

En referensbild förankrar den första bildrutan och texten beskriver vad som händer därefter. Tillverkaren stöder referenser i JPEG, PNG och WebP och kräver att bilden matchar den önskade videostorleken. Förbered motiv, miljö och komposition i den inledande bilden och be sedan om en specifik rörelse. Detta är en referens för första bildrutan, ingen garanti för att varje detalj matchar genom hela klippet.

Återanvändbara icke-mänskliga karaktärer

Tillverkarens utökade arbetsflöde kan skapa en återanvändbar karaktärstillgång från en kort referensvideo av ett djur, en maskot eller ett föremål. Förberedelseanvisningarna anger ett MP4-klipp på omkring två till fyra sekunder, i 720p till 1080p, med bildförhållandet 16:9 eller 9:16. Att matcha källans och utdatans bildförhållande hjälper till att undvika ett utdraget utseende. Genereringen kan referera till upp till två karaktärer.

Behåll karaktärens identifierare och nämn dess namn i prompten; att enbart skicka identifieraren uppfyller inte guidens fullständiga förberedelse. Karaktärstillgångar kan följa med en bildstyrd generering, men videoförlängningar accepterar dem inte. Tillverkaren blockerar som standard uppladdning av karaktärer med mänskliga drag och avvisar referensbilder som innehåller mänskliga ansikten i det dokumenterade API-flödet. Sora-appens funktioner för personliga karaktärer är ett separat produktflöde.

Fortsätt eller redigera ett färdigt klipp

En förlängning tar en färdig källvideo och en fortsättningsprompt och använder hela källklippet som kontext för rörelse, kamerariktning och scenkontinuitet. Guiden beskriver tillägg på upp till 20 sekunder per förlängning. Dess dokumenterade indata för förlängning är källvideon och text; ytterligare karaktärs- eller bildreferenser är uteslutna i det läget. Beskriv hur den befintliga handlingen fortsätter i stället för att införa en orelaterad scen utan övergång.

Videoredigering riktar sig mot en tydlig ändring i ett befintligt klipp. En avgränsad revidering kan ändra ett föremåls färg eller scenens palett samtidigt som resten av tagningen behålls. Tillverkarens guide rekommenderar en väldefinierad ändring åt gången och skiljer redigering av en genererad video från uppladdning av valfritt filmmaterial, som har ett separat behörighetsvillkor. Behåll den färdiga källan och ange exakt vilken revidering som behövs innan du gör nästa redigering.

Renderingsjobb och den färdiga videon

Tillverkarens dokumenterade videoflöde är asynkront: ett inskickat jobb kan stå i kö eller pågå innan det slutförs eller misslyckas. Ett slutfört jobb ger en MP4-video; miniatyrbilder och spriteark stöder förhandsvisning och bläddring. Behåll jobbets identitet kopplad till prompten, referenserna och de returnerade tillgångarna. Ett första jobbsvar är inte den slutliga spelbara videon.

Det vanliga nedladdningsflödet anger en livslängd på en timme för nedladdningsadressen. Det utökade batchflödet förbereder fristående JSON-förfrågningar för rendering med stabila objektidentifierare, uppladdade referenser och ett resultat kopplat till varje tagning; dess färdiga tillgångar har en separat nedladdningsperiod på upp till 24 timmar. Spara det färdiga klippet snarast och granska den faktiska bilden och ljudet innan det betraktas som en vald tagning.

Tillverkarens dokumenterade innehållsbegränsningar för API:et kräver material som lämpar sig för publik under 18 år och avvisar upphovsrättsskyddade karaktärer eller musik samt generering av verkliga personer. Förbered scenen och referenserna därefter. Modellens direkta resultat är video med ljud, inga genererade stillbilder, inget verktygssvar i en konversation och ingen obegränsad film. Behåll standardmodellens exakta identitet och det accepterade källklippet när ett visuellt koncept vidareutvecklas.

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

sora-2

Annat /sora-2

Start

Godkända indata: Text
Resultat: json · sse

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Chat Completions POST /v1/chat/completions

Indatatyper: text
Utdatatyper: json, sse
Utdataformat: JSON eller text/event-stream

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser sora-2	Standard—
Fält`messages`	Typ`message[]`	KravObligatoriskt	Värden & gränser	Standard—
Fält`messages[].role`	Typ`string`	KravObligatoriskt	Värden & gränser	Standard—
Fält`messages[].content`	Typ`string`	KravObligatoriskt	Värden & gränser	Standard—
Fält`stream`	Typ`boolean`	KravValfritt	Värden & gränser	Standardfalse

Kombinationer av indatamaterial

owned_text_messages

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, messages
Parameter`material_types`	Avtaltext
Parameter`messages`	Avtalmeddelandearray med role och innehåll som en bokstavlig textsträng
Parameter`file_material`	AvtalFaktiskt UTF-8-material får infogas som bokstavligt stränginnehåll; ingen filreferens förutsätts.
Parameter`optional_controls`	Avtalstream

Livscykel: synchronous_json_or_sse

Priser

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Ailoot-priser

Priser efter konfiguration

Konfiguration	Prislista	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Avgift Indata · Indatatoken $0 / 1K token Utdata · Utdatatoken $0.2 / 1K token Indata · Cacheläsning $0 / 1K token Indata · Skrivning till cache $0 / 1K token Indata · Skrivning till cache, 1 tim — / 1K token

Ailoot reserverar ett uppskattat belopp före en begäran. Efter resultatet slutregleras avgiften utifrån uppmätt förbrukning. Slutreglering för strömning använder den slutliga förbrukningsposten. Så fungerar reservation och slutreglering →

Exempelbegäranden

Ailoot Ultra · Chat Completions

curl · komplett JSON-svarPython SDK · komplett JSON-svarcurl · bevara SSE-strömmen

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

Ta emot och spara resultat

Ailoot Ultra · Chat Completions

JSON eller text/event-stream

Behåll alla färdiga resultat

Behåll varje fullständigt returnerat svar, fil och innehållsdel.

Behåll samtliga JSON- eller SSE-byte, svarshuvuden, returnerad förbrukning och alla medföljande resultatfält. Ingen modellspecifik resultatfamilj fastställs.

Om det ursprungliga svaret behöver kontrolleras

Bevara det ursprungliga svaret och försöksidentiteten; ingen ny jobbkontroll eller omsändning förutsätts.

Svarsfält

Fält	Typ	Betydelse
Fält`complete response JSON`	Typobject	BetydelseBevara varje returnerat fält utan att anta en modellspecifik resultatfamilj.
Fält`SSE data events`	Typstream	BetydelseBevara varje returnerad händelse och slutmarkör utan att välja enbart textfält.

Alias

Modellalias

Ailoot Ultra sora-2

Alias för metodsökvägar

Använd metodsökvägarna som visas ovan.

Relaterade anropar-ID:n

sora-2

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

sora-2

Annat /sora-2

Start

Godkända indata: Text
Resultat: json · sse

Tillgängligt i Ailoot · indata & metoder

Ailoot Ultra · Anthropic Messages POST /v1/messages

Indatatyper: text
Utdatatyper: json, sse
Utdataformat: JSON eller SSE

Fält	Typ	Krav	Värden & gränser	Standard
Fält`model`	Typ`string`	KravObligatoriskt	Värden & gränser sora-2	Standard—
Fält`messages`	Typ`message[]`	KravObligatoriskt	Värden & gränser	Standard—
Fält`messages[].role`	Typ`string`	KravObligatoriskt	Värden & gränser user, assistant	Standard—
Fält`messages[].content`	Typ`string`	KravObligatoriskt	Värden & gränser	Standard—
Fält`max_tokens`	Typ`integer`	KravObligatoriskt	Värden & gränser	Standard—
Fält`stream`	Typ`boolean`	KravValfritt	Värden & gränser	Standardfalse

Kombinationer av indatamaterial

Text · UTF-8-text

sträng i messages[].content

Metodparametrar och livscykel

Parameter	Avtal
Parameter`content_type`	Avtalapplication/json
Parameter`required`	Avtalmodel, messages, max_tokens
Parameter`optional_controls`	Avtalstream
Parameter`material_types`	Avtaltext
Parameter`text_file_material`	AvtalLäs det faktiska UTF-8-dokumentet och placera texten i det angivna input-fältet eller i strängen för meddelandets innehåll.

Livscykel: synchronous_or_streamed

Priser

Tariffuppgifter lägger inte till begäransalternativ. Parametrar som stöds anges för den valda metoden.

Snabbt läge: Ej angivet När snabbt läge är valt
Flex-läge: Ej angivet När läget flex är valt
Högsta resonemangsnivå: Ej angivet När den högsta resonemangsnivån använder standardjusteringen (default)

Ailoot-priser

Priser efter konfiguration

Konfiguration	Prislista	Avgift
KonfigurationGrundpriser för token	PrislistaGrundpris	Avgift Indata · Indatatoken $0 / 1K token Utdata · Utdatatoken $0.2 / 1K token Indata · Cacheläsning $0 / 1K token Indata · Skrivning till cache $0 / 1K token Indata · Skrivning till cache, 1 tim — / 1K token

Exempelbegäranden

Ailoot Ultra · Anthropic Messages

Komplett minimal JSON-kroppcurl · använd ditt UTF-8-dokumentPython · spara hela resultatet

{
  "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))

Ta emot och spara resultat

Ailoot Ultra · Anthropic Messages

JSON eller SSE

Behåll alla färdiga resultat

Behåll varje fullständigt returnerat svar, fil och innehållsdel.

Behåll alla innehållsblock, resonemangssignaturer och faktiska ID:n för verktygsanvändning. Sätt samman alla SSE-deltauppdateringar för blocken; ett första textblock är inte hela utdata.

Om det ursprungliga svaret behöver kontrolleras

Behåll begärans/svarets ID:n och huvuden. Ingen generell URL för hämtning av textjobb tillhandahålls.

Svarsfält

Fält	Typ
Fält`id`	Typstring
Fält`model`	Typstring
Fält`content[]`	Typtext\|thinking\|tool_use\|other content block
Fält`stop_reason`	Typstring\|null
Fält`usage`	Typobject

Fel och nästa steg

Svar	Villkor	Nästa steg
Svar400 · `invalid_request_error`	VillkorOgiltiga obligatoriska fält, ogiltig representation av underlaget eller ogiltigt parametervärde	Nästa stegKorrigera de angivna fälten före en ny begäran om att skapa.

Alias

Modellalias

Ailoot Ultra sora-2

Alias för metodsökvägar

Använd metodsökvägarna som visas ovan.

Relaterade anropar-ID:n

sora-2

FAQ · sora-2

Vilka indata och resultat finns?

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

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

Vilka fält använder begäran?

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

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

sora-2

sora-2

Beskriv en tagning som går att se och höra

Regissera dialog och ljud separat

Storlek, längd och en bildstyrd inledning

Återanvändbara icke-mänskliga karaktärer

Fortsätt eller redigera ett färdigt klipp

Renderingsjobb och den färdiga videon

Start

Tillgängligt i Ailoot · indata & metoder

Priser

Ailoot-priser

Priser efter konfiguration

Exempelbegäranden

Ailoot Ultra · Chat Completions

Ta emot och spara resultat

Ailoot Ultra · Chat Completions

Behåll alla färdiga resultat

Om det ursprungliga svaret behöver kontrolleras

Alias

Modellalias

Alias för metodsökvägar

Relaterade anropar-ID:n

Start

Tillgängligt i Ailoot · indata & metoder

Priser

Ailoot-priser

Priser efter konfiguration

Exempelbegäranden

Ailoot Ultra · Anthropic Messages

Ta emot och spara resultat

Ailoot Ultra · Anthropic Messages

Behåll alla färdiga resultat

Om det ursprungliga svaret behöver kontrolleras

Alias

Modellalias

Alias för metodsökvägar

Relaterade anropar-ID:n

Företaget och dess projektportfölj

Köp token med rabatt.

Anslut API till produkten som du säljer.