Sora 2 is het video- en audiogeneratiemodel van OpenAI voor dynamische clips op basis van een geschreven scènebeschrijving of een referentieafbeelding. Het genereert de beeldenreeks samen met gesynchroniseerde spraak, effecten en achtergrondgeluid. Het standaardprofiel Sora 2 is bedoeld voor visuele verkenning, conceptontwikkeling, prototypes en ruwe montages. Sora 2 Pro is een afzonderlijke editie die op een grotere beeldgetrouwheid en afwerking op hogere resolutie gericht is.
De promptinggids van de maker bouwt een bruikbare briefing op rond kadrering, onderwerp, actie, omgeving en licht. Geef de scène een samenhangende visuele stijl en beschrijf de beweging vervolgens in duidelijke momenten. Een origineel productconcept kan een klein mechanisch voorwerp tonen dat eenmaal op een werkbank ronddraait terwijl de camera langzaam dichterbij komt, met zacht raamlicht en een subtiel motorgeluid. Geef aan wat de kijker moet opmerken en hoe de actie eindigt.
Houd de camerabeweging en de actie van het onderwerp in elk shot begrijpelijk. Een ingewikkelde sequentie kan in afzonderlijke shotblokken worden opgedeeld, elk met een eigen kadrering, actie en belichting. Behoud dezelfde onderwerpdetails en hetzelfde kleurenpalet wanneer meerdere clips samen één sequentie moeten vormen. De gids benadrukt dat kortere shots de aanwijzingen doorgaans betrouwbaarder volgen en dat herhaalde generaties met dezelfde prompt verschillende takes opleveren.
Bij de lancering van het model worden verbeterd fysiek gedrag en betere continuïteit tussen shots beschreven, onder meer in realistische, filmische en animestijlen. Dit zijn beoogde mogelijkheden die je moet aansturen en beoordelen. Controleer beweging, contact tussen voorwerpen, verhoudingen en continuïteit in plaats van aan te nemen dat een geloofwaardig eerste beeld een samenhangende sequentie garandeert. Vereenvoudig een onduidelijke actie en geef die een zichtbaar begin en einde.
Geef gesproken tekst apart van de visuele beschrijving op en label de sprekers consequent. Houd dialogen kort genoeg om bij de actie en de beoogde cliplengte te passen. Laat in een animatie met twee personages een korte vraag en een kort antwoord op elkaar volgen, in plaats van een lange toespraak in een kort shot te willen verwerken. De gids waarschuwt dat ingewikkelde, lange dialogen het tempo en de synchronisatie kunnen verstoren.
Beschrijf het klanklandschap dat bij de scène hoort: het geluid van een kleine beweging, de omgevingsklank van een ruimte of het ritme van een omgevingseffect. Leg uit welk geluid met de actie moet samenvallen. Beluister de resulterende spraak en effecten samen met het beeld en controleer de toewijzing aan sprekers, de bewoording en de timing. Gesynchroniseerde audio maakt deel uit van de gegenereerde clip en is geen afzonderlijk tekstantwoord.
De gedocumenteerde uitvoerformaten van het standaardmodel zijn 720×1280 staand en 1280×720 liggend. Formaten met een hogere resolutie uit het Pro-profiel mogen niet aan standaard Sora 2 worden toegeschreven. Formaat en duur zijn expliciete aanvraaginstellingen; een ander formaat in de prompt schrijven of om een langere film vragen, wijzigt die instellingen niet. De referentie voor het aanmaken vermeldt clipinstellingen van 4, 8 en 12 seconden. Kies dus een kort, afgebakend actiemoment wanneer je een shot voorbereidt. De uitgebreide workflow van de producent documenteert ook clipinstellingen van 16 en 20 seconden.
Een referentieafbeelding legt het eerste beeld vast en de tekst beschrijft wat er daarna gebeurt. De producent ondersteunt referenties in JPEG, PNG en WebP en vereist dat de afbeelding overeenkomt met het beoogde videoformaat. Bereid het onderwerp, de omgeving en de compositie in die openingsafbeelding voor en vraag vervolgens om een specifieke beweging. Dit is een referentie voor het openingsbeeld, geen garantie dat elk detail gedurende de hele clip overeenkomt.
De uitgebreide workflow van de producent kan een herbruikbaar personagebestand aanmaken op basis van een korte referentievideo van een dier, mascotte of voorwerp. De voorbereidingsrichtlijnen vragen om een MP4-clip van ongeveer twee tot vier seconden, 720p tot 1080p, in 16:9 of 9:16. Dezelfde beeldverhouding voor bron en uitvoer helpt een uitgerekt uiterlijk te vermijden. De generatie kan naar maximaal twee personages verwijzen.
Bewaar de personage-identifier en vermeld de naam in de prompt; alleen de identifier doorgeven is volgens de gids geen volledige voorbereiding. Personagebestanden kunnen samen met een generatie op basis van een afbeelding worden gebruikt, maar videoverlengingen aanvaarden ze niet. De producent blokkeert standaard uploads van personages die op mensen lijken en weigert in de gedocumenteerde API-flow referentieafbeeldingen met menselijke gezichten. De functies voor persoonlijke personages in de Sora-app vormen een afzonderlijke productworkflow.
Een verlenging gebruikt een voltooide bronvideo en een prompt voor de voortzetting, met de volledige bronclip als context voor beweging, camerarichting en continuïteit van de scène. De gids beschrijft toevoegingen van maximaal 20 seconden per verlenging. De gedocumenteerde invoer voor verlenging bestaat uit de bronvideo en tekst; extra personage- of afbeeldingsreferenties zijn uitgesloten van die modus. Beschrijf hoe de bestaande actie doorgaat in plaats van zonder overgang een ongerelateerde scène te introduceren.
Videobewerking richt zich op een duidelijke wijziging aan een bestaande clip. Een gerichte herwerking kan de kleur van een voorwerp of het kleurenpalet van de scène aanpassen en de rest van het shot behouden. De gids van de producent beveelt één goed afgebakende wijziging per keer aan en maakt onderscheid tussen het bewerken van een gegenereerde video en het uploaden van willekeurig beeldmateriaal, waarvoor een afzonderlijke toelatingsvoorwaarde geldt. Bewaar de voltooide bron en bepaal de exact gewenste wijziging voordat je nog een bewerking uitvoert.
De gedocumenteerde videoflow van de producent verloopt asynchroon: een ingediende taak kan in de wachtrij staan of in uitvoering zijn voordat die voltooid wordt of mislukt. Een voltooide taak levert een MP4-video op; miniaturen en sprite sheets ondersteunen voorvertoningen en het doorbladeren. Houd de taakidentiteit gekoppeld aan de prompt, referenties en teruggegeven bestanden. Een eerste taakantwoord is niet de uiteindelijke afspeelbare video.
De gewone downloadworkflow vermeldt een geldigheidsduur van één uur voor download-URL's. De uitgebreide batchworkflow bereidt onafhankelijke JSON-renderaanvragen voor met stabiele itemidentifiers, geüploade referenties en een resultaat dat aan elk shot teruggekoppeld wordt; de voltooide bestanden hebben een afzonderlijke downloadperiode van maximaal 24 uur. Bewaar de afgewerkte clip tijdig en beoordeel het werkelijke beeld en geluid voordat je die als een geselecteerde take beschouwt.
De gedocumenteerde API-inhoudsbeperkingen van de producent vereisen materiaal dat geschikt is voor een publiek jonger dan 18 jaar en weigeren auteursrechtelijk beschermde personages of muziek en het genereren van echte personen. Bereid de scène en referenties daarop voor. Het directe modelresultaat is video met audio, geen gegenereerde stilstaande beelden, een gesprekstoolantwoord of een film van onbeperkte lengte. Behoud de exacte identiteit van het standaardmodel en de aanvaarde bronclip wanneer je een visueel concept voortzet.
", "aboutText": "Sora 2 is het video- en audiogeneratiemodel van OpenAI voor dynamische clips op basis van een geschreven scènebeschrijving of een referentieafbeelding. Het genereert de beeldenreeks samen met gesynchroniseerde spraak, effecten en achtergrondgeluid. Het standaardprofiel Sora 2 is bedoeld voor visuele verkenning, conceptontwikkeling, prototypes en ruwe montages. Sora 2 Pro is een afzonderlijke editie die op een grotere beeldgetrouwheid en afwerking op hogere resolutie gericht is.\n\n### Beschrijf een shot dat te zien en te horen is\n\nDe promptinggids van de maker bouwt een bruikbare briefing op rond kadrering, onderwerp, actie, omgeving en licht. Geef de scène een samenhangende visuele stijl en beschrijf de beweging vervolgens in duidelijke momenten. Een origineel productconcept kan een klein mechanisch voorwerp tonen dat eenmaal op een werkbank ronddraait terwijl de camera langzaam dichterbij komt, met zacht raamlicht en een subtiel motorgeluid. Geef aan wat de kijker moet opmerken en hoe de actie eindigt.\n\nHoud de camerabeweging en de actie van het onderwerp in elk shot begrijpelijk. Een ingewikkelde sequentie kan in afzonderlijke shotblokken worden opgedeeld, elk met een eigen kadrering, actie en belichting. Behoud dezelfde onderwerpdetails en hetzelfde kleurenpalet wanneer meerdere clips samen één sequentie moeten vormen. De gids benadrukt dat kortere shots de aanwijzingen doorgaans betrouwbaarder volgen en dat herhaalde generaties met dezelfde prompt verschillende takes opleveren.\n\nBij de lancering van het model worden verbeterd fysiek gedrag en betere continuïteit tussen shots beschreven, onder meer in realistische, filmische en animestijlen. Dit zijn beoogde mogelijkheden die je moet aansturen en beoordelen. Controleer beweging, contact tussen voorwerpen, verhoudingen en continuïteit in plaats van aan te nemen dat een geloofwaardig eerste beeld een samenhangende sequentie garandeert. Vereenvoudig een onduidelijke actie en geef die een zichtbaar begin en einde.\n\n### Stuur dialoog en geluid afzonderlijk aan\n\nGeef gesproken tekst apart van de visuele beschrijving op en label de sprekers consequent. Houd dialogen kort genoeg om bij de actie en de beoogde cliplengte te passen. Laat in een animatie met twee personages een korte vraag en een kort antwoord op elkaar volgen, in plaats van een lange toespraak in een kort shot te willen verwerken. De gids waarschuwt dat ingewikkelde, lange dialogen het tempo en de synchronisatie kunnen verstoren.\n\nBeschrijf het klanklandschap dat bij de scène hoort: het geluid van een kleine beweging, de omgevingsklank van een ruimte of het ritme van een omgevingseffect. Leg uit welk geluid met de actie moet samenvallen. Beluister de resulterende spraak en effecten samen met het beeld en controleer de toewijzing aan sprekers, de bewoording en de timing. Gesynchroniseerde audio maakt deel uit van de gegenereerde clip en is geen afzonderlijk tekstantwoord.\n\n### Formaat, duur en een opening op basis van een afbeelding\n\nDe gedocumenteerde uitvoerformaten van het standaardmodel zijn 720×1280 staand en 1280×720 liggend. Formaten met een hogere resolutie uit het Pro-profiel mogen niet aan standaard Sora 2 worden toegeschreven. Formaat en duur zijn expliciete aanvraaginstellingen; een ander formaat in de prompt schrijven of om een langere film vragen, wijzigt die instellingen niet. De referentie voor het aanmaken vermeldt clipinstellingen van 4, 8 en 12 seconden. Kies dus een kort, afgebakend actiemoment wanneer je een shot voorbereidt. De uitgebreide workflow van de producent documenteert ook clipinstellingen van 16 en 20 seconden.\n\nEen referentieafbeelding legt het eerste beeld vast en de tekst beschrijft wat er daarna gebeurt. De producent ondersteunt referenties in JPEG, PNG en WebP en vereist dat de afbeelding overeenkomt met het beoogde videoformaat. Bereid het onderwerp, de omgeving en de compositie in die openingsafbeelding voor en vraag vervolgens om een specifieke beweging. Dit is een referentie voor het openingsbeeld, geen garantie dat elk detail gedurende de hele clip overeenkomt.\n\n### Herbruikbare niet-menselijke personages\n\nDe uitgebreide workflow van de producent kan een herbruikbaar personagebestand aanmaken op basis van een korte referentievideo van een dier, mascotte of voorwerp. De voorbereidingsrichtlijnen vragen om een MP4-clip van ongeveer twee tot vier seconden, 720p tot 1080p, in 16:9 of 9:16. Dezelfde beeldverhouding voor bron en uitvoer helpt een uitgerekt uiterlijk te vermijden. De generatie kan naar maximaal twee personages verwijzen.\n\nBewaar de personage-identifier en vermeld de naam in de prompt; alleen de identifier doorgeven is volgens de gids geen volledige voorbereiding. Personagebestanden kunnen samen met een generatie op basis van een afbeelding worden gebruikt, maar videoverlengingen aanvaarden ze niet. De producent blokkeert standaard uploads van personages die op mensen lijken en weigert in de gedocumenteerde API-flow referentieafbeeldingen met menselijke gezichten. De functies voor persoonlijke personages in de Sora-app vormen een afzonderlijke productworkflow.\n\n### Zet een voltooide clip voort of bewerk die\n\nEen verlenging gebruikt een voltooide bronvideo en een prompt voor de voortzetting, met de volledige bronclip als context voor beweging, camerarichting en continuïteit van de scène. De gids beschrijft toevoegingen van maximaal 20 seconden per verlenging. De gedocumenteerde invoer voor verlenging bestaat uit de bronvideo en tekst; extra personage- of afbeeldingsreferenties zijn uitgesloten van die modus. Beschrijf hoe de bestaande actie doorgaat in plaats van zonder overgang een ongerelateerde scène te introduceren.\n\nVideobewerking richt zich op een duidelijke wijziging aan een bestaande clip. Een gerichte herwerking kan de kleur van een voorwerp of het kleurenpalet van de scène aanpassen en de rest van het shot behouden. De gids van de producent beveelt één goed afgebakende wijziging per keer aan en maakt onderscheid tussen het bewerken van een gegenereerde video en het uploaden van willekeurig beeldmateriaal, waarvoor een afzonderlijke toelatingsvoorwaarde geldt. Bewaar de voltooide bron en bepaal de exact gewenste wijziging voordat je nog een bewerking uitvoert.\n\n### Rendertaken en de afgewerkte video\n\nDe gedocumenteerde videoflow van de producent verloopt asynchroon: een ingediende taak kan in de wachtrij staan of in uitvoering zijn voordat die voltooid wordt of mislukt. Een voltooide taak levert een MP4-video op; miniaturen en sprite sheets ondersteunen voorvertoningen en het doorbladeren. Houd de taakidentiteit gekoppeld aan de prompt, referenties en teruggegeven bestanden. Een eerste taakantwoord is niet de uiteindelijke afspeelbare video.\n\nDe gewone downloadworkflow vermeldt een geldigheidsduur van één uur voor download-URL's. De uitgebreide batchworkflow bereidt onafhankelijke JSON-renderaanvragen voor met stabiele itemidentifiers, geüploade referenties en een resultaat dat aan elk shot teruggekoppeld wordt; de voltooide bestanden hebben een afzonderlijke downloadperiode van maximaal 24 uur. Bewaar de afgewerkte clip tijdig en beoordeel het werkelijke beeld en geluid voordat je die als een geselecteerde take beschouwt.\n\nDe gedocumenteerde API-inhoudsbeperkingen van de producent vereisen materiaal dat geschikt is voor een publiek jonger dan 18 jaar en weigeren auteursrechtelijk beschermde personages of muziek en het genereren van echte personen. Bereid de scène en referenties daarop voor. Het directe modelresultaat is video met audio, geen gegenereerde stilstaande beelden, een gesprekstoolantwoord of een film van onbeperkte lengte. Behoud de exacte identiteit van het standaardmodel en de aanvaarde bronclip wanneer je een visueel concept voortzet.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "9f2230de17c98e102b2a2558619d229135f6b6df34eebe2934bca3b04a814fef", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "nl-be", "methods": [ { "html": "sora-2Sora 2 maakt video met gesynchroniseerde dialogen, geluidseffecten en achtergrondgeluid op basis van tekst of een referentieafbeelding. Het standaardprofiel ondersteunt visuele verkenning en conceptclips, met afzonderlijke workflows van de producent voor herbruikbare niet-menselijke personages, voortzettingen en gerichte videobewerkingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Sora 2 is het video- en audiogeneratiemodel van OpenAI voor dynamische clips op basis van een geschreven scènebeschrijving of een referentieafbeelding. Het genereert de beeldenreeks samen met gesynchroniseerde spraak, effecten en achtergrondgeluid. Het standaardprofiel Sora 2 is bedoeld voor visuele verkenning, conceptontwikkeling, prototypes en ruwe montages. Sora 2 Pro is een afzonderlijke editie die op een grotere beeldgetrouwheid en afwerking op hogere resolutie gericht is.
De promptinggids van de maker bouwt een bruikbare briefing op rond kadrering, onderwerp, actie, omgeving en licht. Geef de scène een samenhangende visuele stijl en beschrijf de beweging vervolgens in duidelijke momenten. Een origineel productconcept kan een klein mechanisch voorwerp tonen dat eenmaal op een werkbank ronddraait terwijl de camera langzaam dichterbij komt, met zacht raamlicht en een subtiel motorgeluid. Geef aan wat de kijker moet opmerken en hoe de actie eindigt.
Houd de camerabeweging en de actie van het onderwerp in elk shot begrijpelijk. Een ingewikkelde sequentie kan in afzonderlijke shotblokken worden opgedeeld, elk met een eigen kadrering, actie en belichting. Behoud dezelfde onderwerpdetails en hetzelfde kleurenpalet wanneer meerdere clips samen één sequentie moeten vormen. De gids benadrukt dat kortere shots de aanwijzingen doorgaans betrouwbaarder volgen en dat herhaalde generaties met dezelfde prompt verschillende takes opleveren.
Bij de lancering van het model worden verbeterd fysiek gedrag en betere continuïteit tussen shots beschreven, onder meer in realistische, filmische en animestijlen. Dit zijn beoogde mogelijkheden die je moet aansturen en beoordelen. Controleer beweging, contact tussen voorwerpen, verhoudingen en continuïteit in plaats van aan te nemen dat een geloofwaardig eerste beeld een samenhangende sequentie garandeert. Vereenvoudig een onduidelijke actie en geef die een zichtbaar begin en einde.
Geef gesproken tekst apart van de visuele beschrijving op en label de sprekers consequent. Houd dialogen kort genoeg om bij de actie en de beoogde cliplengte te passen. Laat in een animatie met twee personages een korte vraag en een kort antwoord op elkaar volgen, in plaats van een lange toespraak in een kort shot te willen verwerken. De gids waarschuwt dat ingewikkelde, lange dialogen het tempo en de synchronisatie kunnen verstoren.
Beschrijf het klanklandschap dat bij de scène hoort: het geluid van een kleine beweging, de omgevingsklank van een ruimte of het ritme van een omgevingseffect. Leg uit welk geluid met de actie moet samenvallen. Beluister de resulterende spraak en effecten samen met het beeld en controleer de toewijzing aan sprekers, de bewoording en de timing. Gesynchroniseerde audio maakt deel uit van de gegenereerde clip en is geen afzonderlijk tekstantwoord.
De gedocumenteerde uitvoerformaten van het standaardmodel zijn 720×1280 staand en 1280×720 liggend. Formaten met een hogere resolutie uit het Pro-profiel mogen niet aan standaard Sora 2 worden toegeschreven. Formaat en duur zijn expliciete aanvraaginstellingen; een ander formaat in de prompt schrijven of om een langere film vragen, wijzigt die instellingen niet. De referentie voor het aanmaken vermeldt clipinstellingen van 4, 8 en 12 seconden. Kies dus een kort, afgebakend actiemoment wanneer je een shot voorbereidt. De uitgebreide workflow van de producent documenteert ook clipinstellingen van 16 en 20 seconden.
Een referentieafbeelding legt het eerste beeld vast en de tekst beschrijft wat er daarna gebeurt. De producent ondersteunt referenties in JPEG, PNG en WebP en vereist dat de afbeelding overeenkomt met het beoogde videoformaat. Bereid het onderwerp, de omgeving en de compositie in die openingsafbeelding voor en vraag vervolgens om een specifieke beweging. Dit is een referentie voor het openingsbeeld, geen garantie dat elk detail gedurende de hele clip overeenkomt.
De uitgebreide workflow van de producent kan een herbruikbaar personagebestand aanmaken op basis van een korte referentievideo van een dier, mascotte of voorwerp. De voorbereidingsrichtlijnen vragen om een MP4-clip van ongeveer twee tot vier seconden, 720p tot 1080p, in 16:9 of 9:16. Dezelfde beeldverhouding voor bron en uitvoer helpt een uitgerekt uiterlijk te vermijden. De generatie kan naar maximaal twee personages verwijzen.
Bewaar de personage-identifier en vermeld de naam in de prompt; alleen de identifier doorgeven is volgens de gids geen volledige voorbereiding. Personagebestanden kunnen samen met een generatie op basis van een afbeelding worden gebruikt, maar videoverlengingen aanvaarden ze niet. De producent blokkeert standaard uploads van personages die op mensen lijken en weigert in de gedocumenteerde API-flow referentieafbeeldingen met menselijke gezichten. De functies voor persoonlijke personages in de Sora-app vormen een afzonderlijke productworkflow.
Een verlenging gebruikt een voltooide bronvideo en een prompt voor de voortzetting, met de volledige bronclip als context voor beweging, camerarichting en continuïteit van de scène. De gids beschrijft toevoegingen van maximaal 20 seconden per verlenging. De gedocumenteerde invoer voor verlenging bestaat uit de bronvideo en tekst; extra personage- of afbeeldingsreferenties zijn uitgesloten van die modus. Beschrijf hoe de bestaande actie doorgaat in plaats van zonder overgang een ongerelateerde scène te introduceren.
Videobewerking richt zich op een duidelijke wijziging aan een bestaande clip. Een gerichte herwerking kan de kleur van een voorwerp of het kleurenpalet van de scène aanpassen en de rest van het shot behouden. De gids van de producent beveelt één goed afgebakende wijziging per keer aan en maakt onderscheid tussen het bewerken van een gegenereerde video en het uploaden van willekeurig beeldmateriaal, waarvoor een afzonderlijke toelatingsvoorwaarde geldt. Bewaar de voltooide bron en bepaal de exact gewenste wijziging voordat je nog een bewerking uitvoert.
De gedocumenteerde videoflow van de producent verloopt asynchroon: een ingediende taak kan in de wachtrij staan of in uitvoering zijn voordat die voltooid wordt of mislukt. Een voltooide taak levert een MP4-video op; miniaturen en sprite sheets ondersteunen voorvertoningen en het doorbladeren. Houd de taakidentiteit gekoppeld aan de prompt, referenties en teruggegeven bestanden. Een eerste taakantwoord is niet de uiteindelijke afspeelbare video.
De gewone downloadworkflow vermeldt een geldigheidsduur van één uur voor download-URL's. De uitgebreide batchworkflow bereidt onafhankelijke JSON-renderaanvragen voor met stabiele itemidentifiers, geüploade referenties en een resultaat dat aan elk shot teruggekoppeld wordt; de voltooide bestanden hebben een afzonderlijke downloadperiode van maximaal 24 uur. Bewaar de afgewerkte clip tijdig en beoordeel het werkelijke beeld en geluid voordat je die als een geselecteerde take beschouwt.
De gedocumenteerde API-inhoudsbeperkingen van de producent vereisen materiaal dat geschikt is voor een publiek jonger dan 18 jaar en weigeren auteursrechtelijk beschermde personages of muziek en het genereren van echte personen. Bereid de scène en referenties daarop voor. Het directe modelresultaat is video met audio, geen gegenereerde stilstaande beelden, een gesprekstoolantwoord of een film van onbeperkte lengte. Behoud de exacte identiteit van het standaardmodel en de aanvaarde bronclip wanneer je een visueel concept voortzet.
POST /v1/chat/completionstextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten sora-2 | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldmessages[].content | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
owned_text_messages
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages |
Parametermaterial_types | Contracttext |
Parametermessages | Contractarray met berichten met role en content als letterlijke tekenreeks |
Parameterfile_material | ContractWerkelijk UTF-8-materiaal kan als letterlijke tekenreeksinhoud worden ingevoegd; er wordt geen bestandsreferentie uit afgeleid. |
Parameteroptional_controls | Contractstream |
Levenscyclus: synchronous_json_or_sse
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
| Configuratie | Tariefstaffel | Kosten |
|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Kosten Invoer · Invoertokens $0 / 1K tokens Uitvoer · Uitvoertokens $0.2 / 1K tokens Invoer · Cache lezen $0 / 1K tokens Invoer · Cache schrijven $0 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
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 of text/event-stream
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar de volledige JSON- of SSE-bytes, de antwoordheaders, het teruggestuurde verbruik en alle aangeleverde resultaatvelden. Er wordt geen modelspecifieke uitvoerfamilie aangenomen.
Bewaar het oorspronkelijke antwoord en de identiteit van de poging; hieruit wordt geen nieuwe statusopvraging voor een opdracht of nieuwe indiening afgeleid.
| Veld | Type | Betekenis |
|---|---|---|
Veldcomplete response JSON | Typeobject | BetekenisBewaar elk teruggestuurd veld zonder een modelspecifieke resultaatfamilie aan te nemen. |
VeldSSE data events | Typestream | BetekenisBewaar elke teruggestuurde gebeurtenis en eindmarkering zonder uitsluitend tekstvelden te selecteren. |
Ailoot Ultra sora-2
Gebruik de hierboven getoonde methodepaden.
sora-2Sora 2 maakt video met gesynchroniseerde dialogen, geluidseffecten en achtergrondgeluid op basis van tekst of een referentieafbeelding. Het standaardprofiel ondersteunt visuele verkenning en conceptclips, met afzonderlijke workflows van de producent voor herbruikbare niet-menselijke personages, voortzettingen en gerichte videobewerkingen.
Deze beschrijving gaat over de mogelijkheden van het model. De via Ailoot beschikbare invoer, uitvoer en opties staan hieronder voor de geselecteerde methode.
Sora 2 is het video- en audiogeneratiemodel van OpenAI voor dynamische clips op basis van een geschreven scènebeschrijving of een referentieafbeelding. Het genereert de beeldenreeks samen met gesynchroniseerde spraak, effecten en achtergrondgeluid. Het standaardprofiel Sora 2 is bedoeld voor visuele verkenning, conceptontwikkeling, prototypes en ruwe montages. Sora 2 Pro is een afzonderlijke editie die op een grotere beeldgetrouwheid en afwerking op hogere resolutie gericht is.
De promptinggids van de maker bouwt een bruikbare briefing op rond kadrering, onderwerp, actie, omgeving en licht. Geef de scène een samenhangende visuele stijl en beschrijf de beweging vervolgens in duidelijke momenten. Een origineel productconcept kan een klein mechanisch voorwerp tonen dat eenmaal op een werkbank ronddraait terwijl de camera langzaam dichterbij komt, met zacht raamlicht en een subtiel motorgeluid. Geef aan wat de kijker moet opmerken en hoe de actie eindigt.
Houd de camerabeweging en de actie van het onderwerp in elk shot begrijpelijk. Een ingewikkelde sequentie kan in afzonderlijke shotblokken worden opgedeeld, elk met een eigen kadrering, actie en belichting. Behoud dezelfde onderwerpdetails en hetzelfde kleurenpalet wanneer meerdere clips samen één sequentie moeten vormen. De gids benadrukt dat kortere shots de aanwijzingen doorgaans betrouwbaarder volgen en dat herhaalde generaties met dezelfde prompt verschillende takes opleveren.
Bij de lancering van het model worden verbeterd fysiek gedrag en betere continuïteit tussen shots beschreven, onder meer in realistische, filmische en animestijlen. Dit zijn beoogde mogelijkheden die je moet aansturen en beoordelen. Controleer beweging, contact tussen voorwerpen, verhoudingen en continuïteit in plaats van aan te nemen dat een geloofwaardig eerste beeld een samenhangende sequentie garandeert. Vereenvoudig een onduidelijke actie en geef die een zichtbaar begin en einde.
Geef gesproken tekst apart van de visuele beschrijving op en label de sprekers consequent. Houd dialogen kort genoeg om bij de actie en de beoogde cliplengte te passen. Laat in een animatie met twee personages een korte vraag en een kort antwoord op elkaar volgen, in plaats van een lange toespraak in een kort shot te willen verwerken. De gids waarschuwt dat ingewikkelde, lange dialogen het tempo en de synchronisatie kunnen verstoren.
Beschrijf het klanklandschap dat bij de scène hoort: het geluid van een kleine beweging, de omgevingsklank van een ruimte of het ritme van een omgevingseffect. Leg uit welk geluid met de actie moet samenvallen. Beluister de resulterende spraak en effecten samen met het beeld en controleer de toewijzing aan sprekers, de bewoording en de timing. Gesynchroniseerde audio maakt deel uit van de gegenereerde clip en is geen afzonderlijk tekstantwoord.
De gedocumenteerde uitvoerformaten van het standaardmodel zijn 720×1280 staand en 1280×720 liggend. Formaten met een hogere resolutie uit het Pro-profiel mogen niet aan standaard Sora 2 worden toegeschreven. Formaat en duur zijn expliciete aanvraaginstellingen; een ander formaat in de prompt schrijven of om een langere film vragen, wijzigt die instellingen niet. De referentie voor het aanmaken vermeldt clipinstellingen van 4, 8 en 12 seconden. Kies dus een kort, afgebakend actiemoment wanneer je een shot voorbereidt. De uitgebreide workflow van de producent documenteert ook clipinstellingen van 16 en 20 seconden.
Een referentieafbeelding legt het eerste beeld vast en de tekst beschrijft wat er daarna gebeurt. De producent ondersteunt referenties in JPEG, PNG en WebP en vereist dat de afbeelding overeenkomt met het beoogde videoformaat. Bereid het onderwerp, de omgeving en de compositie in die openingsafbeelding voor en vraag vervolgens om een specifieke beweging. Dit is een referentie voor het openingsbeeld, geen garantie dat elk detail gedurende de hele clip overeenkomt.
De uitgebreide workflow van de producent kan een herbruikbaar personagebestand aanmaken op basis van een korte referentievideo van een dier, mascotte of voorwerp. De voorbereidingsrichtlijnen vragen om een MP4-clip van ongeveer twee tot vier seconden, 720p tot 1080p, in 16:9 of 9:16. Dezelfde beeldverhouding voor bron en uitvoer helpt een uitgerekt uiterlijk te vermijden. De generatie kan naar maximaal twee personages verwijzen.
Bewaar de personage-identifier en vermeld de naam in de prompt; alleen de identifier doorgeven is volgens de gids geen volledige voorbereiding. Personagebestanden kunnen samen met een generatie op basis van een afbeelding worden gebruikt, maar videoverlengingen aanvaarden ze niet. De producent blokkeert standaard uploads van personages die op mensen lijken en weigert in de gedocumenteerde API-flow referentieafbeeldingen met menselijke gezichten. De functies voor persoonlijke personages in de Sora-app vormen een afzonderlijke productworkflow.
Een verlenging gebruikt een voltooide bronvideo en een prompt voor de voortzetting, met de volledige bronclip als context voor beweging, camerarichting en continuïteit van de scène. De gids beschrijft toevoegingen van maximaal 20 seconden per verlenging. De gedocumenteerde invoer voor verlenging bestaat uit de bronvideo en tekst; extra personage- of afbeeldingsreferenties zijn uitgesloten van die modus. Beschrijf hoe de bestaande actie doorgaat in plaats van zonder overgang een ongerelateerde scène te introduceren.
Videobewerking richt zich op een duidelijke wijziging aan een bestaande clip. Een gerichte herwerking kan de kleur van een voorwerp of het kleurenpalet van de scène aanpassen en de rest van het shot behouden. De gids van de producent beveelt één goed afgebakende wijziging per keer aan en maakt onderscheid tussen het bewerken van een gegenereerde video en het uploaden van willekeurig beeldmateriaal, waarvoor een afzonderlijke toelatingsvoorwaarde geldt. Bewaar de voltooide bron en bepaal de exact gewenste wijziging voordat je nog een bewerking uitvoert.
De gedocumenteerde videoflow van de producent verloopt asynchroon: een ingediende taak kan in de wachtrij staan of in uitvoering zijn voordat die voltooid wordt of mislukt. Een voltooide taak levert een MP4-video op; miniaturen en sprite sheets ondersteunen voorvertoningen en het doorbladeren. Houd de taakidentiteit gekoppeld aan de prompt, referenties en teruggegeven bestanden. Een eerste taakantwoord is niet de uiteindelijke afspeelbare video.
De gewone downloadworkflow vermeldt een geldigheidsduur van één uur voor download-URL's. De uitgebreide batchworkflow bereidt onafhankelijke JSON-renderaanvragen voor met stabiele itemidentifiers, geüploade referenties en een resultaat dat aan elk shot teruggekoppeld wordt; de voltooide bestanden hebben een afzonderlijke downloadperiode van maximaal 24 uur. Bewaar de afgewerkte clip tijdig en beoordeel het werkelijke beeld en geluid voordat je die als een geselecteerde take beschouwt.
De gedocumenteerde API-inhoudsbeperkingen van de producent vereisen materiaal dat geschikt is voor een publiek jonger dan 18 jaar en weigeren auteursrechtelijk beschermde personages of muziek en het genereren van echte personen. Bereid de scène en referenties daarop voor. Het directe modelresultaat is video met audio, geen gegenereerde stilstaande beelden, een gesprekstoolantwoord of een film van onbeperkte lengte. Behoud de exacte identiteit van het standaardmodel en de aanvaarde bronclip wanneer je een visueel concept voortzet.
POST /v1/messagestextjson, sse| Veld | Type | Vereiste | Waarden en limieten | Standaard |
|---|---|---|---|---|
Veldmodel | Typestring | VereisteVereist | Waarden en limieten sora-2 | Standaard— |
Veldmessages | Typemessage[] | VereisteVereist | Waarden en limieten | Standaard— |
Veldmessages[].role | Typestring | VereisteVereist | Waarden en limieten user, assistant | Standaard— |
Veldmessages[].content | Typestring | VereisteVereist | Waarden en limieten | Standaard— |
Veldmax_tokens | Typeinteger | VereisteVereist | Waarden en limieten | Standaard— |
Veldstream | Typeboolean | VereisteOptioneel | Waarden en limieten | Standaardfalse |
Tekst · UTF-8-tekst
messages[].content als tekenreeks
| Parameter | Contract |
|---|---|
Parametercontent_type | Contractapplication/json |
Parameterrequired | Contractmodel, messages, max_tokens |
Parameteroptional_controls | Contractstream |
Parametermaterial_types | Contracttext |
Parametertext_file_material | ContractLees het werkelijke UTF-8-document en plaats de tekst ervan in de aangegeven invoer of in de inhoudstekenreeks van een bericht. |
Levenscyclus: synchronous_or_streamed
Tariefverwijzingen voegen geen verzoekopties toe. Ondersteunde parameters staan bij de geselecteerde methode.
| Configuratie | Tariefstaffel | Kosten |
|---|---|---|
| ConfiguratieBasistarieven voor tokens | TariefstaffelBasistarief | Kosten Invoer · Invoertokens $0 / 1K tokens Uitvoer · Uitvoertokens $0.2 / 1K tokens Invoer · Cache lezen $0 / 1K tokens Invoer · Cache schrijven $0 / 1K tokens Invoer · Cache schrijven, 1 uur — / 1K tokens |
Ailoot reserveert vóór een verzoek een geschat bedrag. Na het resultaat worden de uiteindelijke kosten afgerekend op basis van het gemeten verbruik. Bij streaming gebeurt de afrekening op basis van de definitieve verbruiksregistratie. Zo werken reservering en afrekening →
{\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 of SSE
Bewaar elk volledig teruggegeven antwoord, bestand en inhoudsonderdeel.
Bewaar alle inhoudsblokken, handtekeningen van redeneringen en werkelijke toolgebruik-ID’s. Voeg alle SSE-blokdelta’s samen; het eerste tekstblok is niet de volledige uitvoer.
Bewaar aanvraag-/antwoord-ID’s en headers. Er wordt geen algemene URL meegeleverd om teksttaken op te halen.
| Veld | Type |
|---|---|
Veldid | Typestring |
Veldmodel | Typestring |
Veldcontent[] | Typetext|thinking|tool_use|other content block |
Veldstop_reason | Typestring|null |
Veldusage | Typeobject |
| Antwoord | Voorwaarde | Volgende stap |
|---|---|---|
Antwoord400 · invalid_request_error | VoorwaardeVerplichte velden, de materiaalrepresentatie of een parameterwaarde zijn ongeldig | Volgende stapCorrigeer de aangegeven velden vóór een nieuwe aanmaakaanvraag. |
Ailoot Ultra sora-2
Gebruik de hierboven getoonde methodepaden.