NL ▾
API-sleutel aanvragen

HomeGids

Bijgewerkt

Hoe een AI een script laat schrijven: promptstructuur

Als je wilt weten hoe je een AI een script kunt laten schrijven dat je echt kunt filmen of voice-over kunt geven, is het antwoord structuur: vertel het model voor wie het script is, hoe lang het duurt en welke vorm de output moet hebben.

Gekoppelde notitietegels die leiden naar een stapel scriptpagina's en een klapper, die outline-vooraf schrijven tonen
Een glazen vat dat gevuld wordt met gloeiende blokken terwijl een pijl eromheen cirkelt, ter illustratie van het contextvenster van een agent

Belangrijkste punten

  1. Geef het model een rol, een lengte in woorden, een toon en een outputformaat. Elk missend item wordt een gok.
  2. Korte scripts passen in één call. Lange hebben eerst een outline nodig, dan calls per scène.
  3. Gebruik een temperatuur van ongeveer 0,8 voor concepten en lager voor bewerkingen; stel stopsequenties in als je een harde eindbeperking nodig hebt.
  4. Het contextvenster van 100.000 tokens bevat een volledige outline plus alle eerdere hoofdstukken, dus je hebt zelden trucjes nodig.

Geen kaart nodig. Na registratie claim je met één klik $0,50 gratis proeftegoed (eenmaal per persoon).

API-sleutel aanvragen

Het korte antwoord: vijf delen in de prompt

De meeste zwakke scripts komen door zwakke prompts. Een verzoek zoals "schrijf een script over koffie" laat het model kiezen voor de lengte, de stem, de vorm en het punt. Geef het in plaats daarvan deze vijf delen:

  1. Doel: wat de kijker moet voelen of doen aan het einde.
  2. Doelgroep en toon: "nieuwe ouders, warm en een beetje moe" werkt beter dan "vriendelijk".
  3. Lengte: in woorden, omdat modellen woorden beter tellen dan seconden. Ongeveer 150 woorden is een minuut spraak.
  4. Indeling: scenario, tweesporige voice-over en beelden, of eenvoudige vertelling.
  5. Beperkingen: dingen om te vermijden, namen om te behouden, een vereiste laatste zin.

Hier is het verschil in de praktijk. Een zwakke prompt: "Schrijf een script over slaap." Een sterkere: "Schrijf een narratie van 120 woorden voor een video van 50 seconden die kantorenwerkers overtuigt om te stoppen met e-mail controleren in bed. Toon: zacht, iets grappig. Begin met een vraag. Eindig met één concreet dat ze vanavond kunnen doen. Noem geen medicatie." De tweede prompt kost ongeveer veertig tokens meer en verwijdert de meeste herschrijfrondes. Behandel de extra woorden als de goedkoopste bewerking die je ooit zult doen.

Dat is de hele methode. De rest van deze pagina laat zien hoe je dit omzet in API-calls, en hoe je het schaleert wanneer het script lang is. Als je alleen een snelle test nodig hebt, geeft de API-sleutelpagina nieuwe accounts een klein trial tegoed.

Kies een formaat en zeg het

Modellen kopiëren het formaat dat je ze laat zien. Als je een tweekolom script wilt, laat één rij zien. Een klein voorbeeld in de prompt is beter dan een alinea beschrijving.

curl https://api.aivideogenapi.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "uncensored",
    "temperature": 0.8,
    "messages": [
      {"role": "system", "content": "You are a scriptwriter. Output a two-column script. Format each row as: VISUAL | NARRATION. About 150 words of narration in total. No headings."},
      {"role": "user", "content": "Topic: why airports smell the way they do. Tone: wry. Audience: adults who travel for work."}
    ]
  }'

Hetzelfde verzoek werkt met elke OpenAI client zodra de basis-URL https://api.aivideogenapi.com/v1 is. Details over authenticatie en velden staan in de documentatie.

Voor dialoogscripts, noem de sprekers in de prompt en geef elk een eenregelige voice note ("Mara: bot, korte zinnen. Ilya: legt te veel uit"). Zonder klinken karakters op pagina twee vaak hetzelfde.

Instellingen die het resultaat beïnvloeden

Een paar parameters zijn belangrijker dan de rest.

OnderdeelGebruik het voorTypische waarde
temperatureVerscheidenheid aan formulering0,7 tot 0,9 voor concepten, 0,3 tot 0,5 voor bewerkingen
top_pSnij onwaarschijnlijke woorden af0,9 tot 0,95; verander dit of de temperatuur, niet beide
max_tokensHarde limiet voor de lengte van het antwoordOptioneel; stel dit in als je een bescherming wilt tegen ontsnappende output
stopEindig op een markerBijvoorbeeld "EINDE SCENE"
frequency_penaltyVermindert herhaalde zinsdelen0,2 tot 0,5 voor lange scripts
seedHerhaalbare conceptenElk geheel getal

Deze worden doorgegeven aan het model. Verwacht niet dezelfde output te krijgen van dezelfde seed nadat je de prompt zelfs maar één woord hebt veranderd.

Korte scripts: één verzoek is genoeg

Een script van 30 tot 90 seconden is een paar honderd woorden. Stuur één verzoek met de vijf delen en vraag om één concept. Gebruik daarna een tweede bericht voor bewerkingen, omdat het bewerken van een concept beter werkt dan opnieuw vanaf nul genereren.

from openai import OpenAI

client = OpenAI(base_url="https://api.aivideogenapi.com/v1", api_key="YOUR_KEY")

messages = [
    {"role": "system", "content": "You write tight scripts for short videos. Plain narration, no stage directions."},
    {"role": "user", "content": "Purpose: make viewers check their router settings. Tone: calm, a little amused. Length: 140 words."},
]
draft = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.8)
text = draft.choices[0].message.content

messages += [
    {"role": "assistant", "content": text},
    {"role": "user", "content": "Keep the structure. Replace the opening line with a question, and cut the last sentence."},
]
final = client.chat.completions.create(model="uncensored", messages=messages, temperature=0.4)
print(final.choices[0].message.content)

Merk de daling van de temperatuur in de tweede call op. Bewerkingen moeten instructies volgen, niet verkennen. Als je het script live wilt zien verschijnen, voeg stream: true toe en print elke chunk naarmate deze aankomt; de gebruikscijfers verschijnen aan het einde van de stream. Een gestreamd verzoek houdt één van je gelijktijdige slots vast tot het klaar is, wat belangrijk is als je meerdere concepten parallel uitvoert. Een volledige sleutel staat 8 tegelijk toe.

Lange scripts: eerst een schets, dan de acts

Vraag om 4.000 woorden in één keer en het midden zakt door: het model haast het einde, herhaalt ideeën en vergeet kleine feiten. Een beter patroon heeft drie stappen.

Stap 1: de outline

Vraag een genummerde outline met één zin per scène, het doel van elke scène en een lopende lijst van feiten die consistent moeten blijven (namen, plaatsen, wat elk karakter weet). Bewerk dit met de hand. Het is de goedkoopste plek om een verhaal te repareren.

Stap 2: per hoofdstuk

Voor elk hoofdstuk, stuur de outline, de stijlregels, een korte samenvatting van eerdere hoofdstukken en de volledige tekst van het laatste hoofdstuk. Vraag alleen om het volgende hoofdstuk.

acts = []
summary = "None yet."
for n, goal in enumerate(outline_acts, start=1):
    prompt = (
        f"Outline:\n{outline_text}\n\nStory so far (summary): {summary}\n"
        f"Previous act, full text:\n{acts[-1] if acts else '(none)'}\n\n"
        f"Write act {n}: {goal}. About 600 words. Match the voice of the previous act."
    )
    r = client.chat.completions.create(
        model="uncensored",
        messages=[{"role": "system", "content": STYLE_RULES}, {"role": "user", "content": prompt}],
        temperature=0.8,
    )
    acts.append(r.choices[0].message.content)
    summary = summarize(acts)  # one more short call

Stap 3: de doorleesfase

Stuur het volledige script terug en vraag om een lijst van contradicties en herhaalde regels, niet een herschrijving. Los die op met gerichte bewerkingen.

Het 100.000-token contextvenster gebruiken

Prompt plus antwoord kunnen 100.000 tokens bereiken, ongeveer 70.000 woorden. Een volledig overzicht, een styleguide en elke voltooide act van een speelfilmscript passen comfortabel. Dat betekent dat je vaak samenvattingen kunt overslaan en gewoon de hele tot nu toe vertelde geschiedenis kunt sturen, waardoor kleine details intact blijven.

Twee waarschuwingen. Ten eerste, de kosten stijgen omdat elk verzoek de geschiedenis opnieuw verstuurt. Ten tweede werken zeer lange prompts nog steeds het beste wanneer de instructies die het meest belangrijk zijn aan het einde staan, dicht bij het verzoek. Plaats de huidige taak als laatste, na het referentiemateriaal. De pagina over het contextvenster gaat dieper in op hoe je lange invoer kunt indelen.

Prijscontrole voor een script van 10 minuten opgebouwd in acts: stel dat de calls samen 6.000 inputtokens en 4.000 outputtokens omvatten. Dat is 6.000 / 1.000.000 x $0,15 = $0,0009 voor input en 4.000 / 1.000.000 x $0,50 = $0,002 voor output, dus $0,0029 in totaal. Prijzen staan op de prijzenpagina.

Veelvoorkomende problemen en fixes

  • Het script is te lang of te kort. Geef een woordbereik op en voeg een stoppunt toe. Controleer het woordenaantal in code en vraag om een trim met het exacte aantal.
  • Elke scène begint op dezelfde manier. Voeg een frequentiestraffing toe en een regel zoals "Varieer hoe scènes beginnen; open nooit twee scènes met een geluid of een weersdetail."
  • De toon wijkt af. Plak twee voorbeeldregels van de gewenste stem in de systeemboodschap en vertel het model dat dit een stijlreferentie is, geen tekst om te hergebruiken.
  • Regie-instructies lekken de vertelling in. Vraag om aparte velden (JSON-modus met response_format ingesteld op json_object) zodat vertelling en beelden nooit een enkele string delen.
  • HTTP 429. Je hebt een limiet geraakt. De code rate_limited betekent te veel verzoeken per minuut, concurrency betekent te veel tegelijk. Wacht en probeer opnieuw.

Vragen en antwoorden

Hoeveel woorden moet ik per minuut video vragen?

Reken op ongeveer 150 gesproken woorden per minuut in een rustig tempo. Snelle sociale clips kunnen 170 of meer bereiken, dus test met een echte voice-over.

Moet ik het hele script in één verzoek genereren?

Voor scripts van minder dan ongeveer 800 woorden: ja. Voor langere scripts: schrijf eerst een schets en genereer per act, waarbij je telkens de schets en de laatste act doorgeeft.

Onthoudt het model iets tussen verzoeken in?

Nee. Elk verzoek is onafhankelijk, dus jij stuurt de geschiedenis die het moet zien via de berichtenlijst.

Kan het donkere of volwassen fictie-scripts schrijven?

Het model is afgestemd om zonder inhoudsbeperkingen te antwoorden voor wettelijk volwassen gebruik. Seksuele inhoud met minderjarigen is echter nooit toegestaan.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de basis-URL aan. Dat is de hele installatie.

API-sleutel aanvragen