NL ▾
API-sleutel aanvragen

HomeGids

Bijgewerkt

AI-scriptschrijver voor video, gebouwd op een LLM-API

Een AI-scriptschrijver voor video is een tekstmodel met een goede prompt eromheen. Deze gids laat zien hoe je er een bouwt op een OpenAI-compatibele API, met een Python-sjabloon en de echte kosten per script.

Filmstrip uitrollen vanaf een terminal, elk frame met een sceneschets, die scriptgeneratie door API voorstelt
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. De API schrijft alleen tekst: scripts, shotlijsten en voice-over. Het rendert geen video.
  2. Vraag om JSON zodat elke scene in een veld terechtkomt dat je editor of videotool kan lezen.
  3. Een script van 60 seconden met shotlijst kost ongeveer een tiende cent bij $0,15 en $0,50 per 1M tokens.
  4. Houd het creative brief, de toon en eerdere scènes in de prompt; het venster is 100.000 tokens.

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

API-sleutel aanvragen

Wat een scriptschrijver eigenlijk doet

Een AI-scriptschrijver voor video neemt een kort idee en retourneert de tekst die een video nodig heeft: een hook, scènes, vertelstem, tekst op het scherm en notities voor beelden. Het model doet het schrijven. Jouw code doet de rest: het bouwt de prompt, stuurt hem, controleert het antwoord en deelt de delen in aan wat dan ook de beelden maakt.

Deze API is alleen tekst. Hij genereert geen afbeeldingen, audio of video. Dat past goed bij de taak, want het script is de stap waarbij de meeste videoprojecten vastlopen, en het is ook de goedkoopste stap om te automatiseren. Beelden en stemmen komen van andere tools die je al gebruikt. Het model, uitgevoerd door een onafhankelijke provider, is afgestemd op antwoorden zonder inhoudsrefusies voor wettelijk volwassen gebruik, wat belangrijk is als je scripts volwassen fictie, horror, misdaadverhalen of donkere humor bevatten. Voor het bredere beeld van hoe tekst past in videopipelines, zie de AI video API-gids.

Drie outputs zijn het proberen waard in één call: de voice-over tekst (wat de verteller zegt), de shotlijst (wat de kijker ziet) en een tijdschatting per scene. Ze in aparte velden splitsen maakt latere stappen eenvoudig.

Stel de client in

De endpoint is OpenAI-compatibel, dus de standaard SDK werkt. Haal een sleutel op de API-sleutelpagina, wiis dan de client aan op de base URL en gebruik de model ID uncensored.

from openai import OpenAI

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

resp = client.chat.completions.create(
    model="uncensored",
    messages=[{"role": "user", "content": "Write a 3-line hook for a video about night trains."}],
)
print(resp.choices[0].message.content)
print(resp.usage)

Hetzelfde verzoek werkt in curl of Node met alleen de base URL en sleutel veranderd. Volledige parameterdetails staan in de API docs. Nieuwe accounts kunnen $0,50 aan proeftegoed claimen met één klik op de sleutelpagina, wat genoeg is om alles in dit artikel vele keren te testen.

Een promptsjabloon dat bruikbare scènes retourneert

Een vaag verzoek geeft vaag scripts. Een goede sjabloon lost vier dingen op: het publiek, de lengte, de toon en het uitvoerformaat. Zet de regels in het system message en het idee in het user message.

import json
from openai import OpenAI

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

SYSTEM = """You write short video scripts.
Return JSON only, with this shape:
{"title": str, "hook": str,
 "scenes": [{"n": int, "seconds": int, "voiceover": str,
             "shot": str, "on_screen_text": str}]}
Rules:
- Total length matches the requested duration.
- Voiceover is spoken language: short sentences, no stage directions.
- 'shot' describes what the camera shows, in one sentence.
- First scene is a hook that works without sound."""

def make_script(idea, seconds=60, tone="dry, curious", audience="adults"):
    user = f"Idea: {idea}\nDuration: {seconds} seconds\nTone: {tone}\nAudience: {audience}"
    r = client.chat.completions.create(
        model="uncensored",
        temperature=0.8,
        response_format={"type": "json_object"},
        messages=[{"role": "system", "content": SYSTEM},
                  {"role": "user", "content": user}],
    )
    return json.loads(r.choices[0].message.content), r.usage

script, usage = make_script("why night trains are coming back")
for s in script["scenes"]:
    print(s["n"], s["seconds"], s["voiceover"])

JSON-modus (response_format met json_object) houdt het antwoord te parseren. Wikkel json.loads nog steeds in een try-blok en probeer het bij een fout één keer opnieuw, omdat elk model af en toe een beschadigde string kan produceren. Een temperatuur van 0,7 tot 0,9 geeft gevarieerde formuleringen; verlaag het naar 0,3 als je een bijna identieke structuur nodig hebt over een batch.

Controleer de lengte voordat je het vertrouwt

Modellen zijn slecht in het tellen van seconden. Een betrouwbare vuistregel is ongeveer 150 gesproken woorden per minuut voor een rustige verteller, iets meer voor snelle sociale clips. Tel na elk verzoek de woorden in alle voice-over-velden en vergelijk ze met het doel.

def spoken_seconds(script, wpm=150):
    words = sum(len(s["voiceover"].split()) for s in script["scenes"])
    return round(words / wpm * 60)

est = spoken_seconds(script)
if abs(est - 60) > 8:
    print("Off target:", est, "seconds. Ask for a rewrite.")

Als het script te lang is, stuur dan een tweede bericht met de exacte cijfers: "De voice-over duurt ongeveer 78 seconden; knip het terug naar 60 zonder de hook te verliezen." Concrete feedback werkt beter dan "maak het korter". Houd het eerste antwoord in de berichtlijst, zodat het model ziet wat het heeft geschreven.

Shotlists en voice-over als aparte passes

Voor langere video's wordt één verzoek voor alles dun. Gebruik in plaats daarvan twee passes. Vraag eerst om een overzicht van scenetitels en één-regel doelen. Genereer vervolgens elke scène in een eigen verzoek, waarbij je het overzicht en de voice-over van de vorige scène doorgeeft, zodat de toon doorwerkt.

  • Ronde 1, overzicht: 6 tot 12 scènes, elk met een doel en een ruwe duur.
  • Pass 2, scènes: voice-over en shot voor één scène tegelijk, met de schets en de laatste twee scènes in context.
  • Ronde 3, polijsten: lees de volledige voiceover hardop voor en vraag om herhalende zinsdelen te variëren.

Het contextvenster is 100.000 tokens voor prompt plus antwoord, dus zelfs een 20-minuten documentaire script met zijn volledige schets past in één gesprek. Voor hoe geheugen zich gedraagt in lange sessies behandelt de pagina over het contextvenster de praktische limieten. Streaming (stream: true) is handig als je het script aan een persoon laat zien terwijl het wordt geschreven.

Wat een script kost

Prijzen zijn $0,15 per 1M invoertokens en $0,50 per 1M uitvoertokens, betaald uit prepaid tegoed. Neem een typisch script van 60 seconden met een shotlist. Stel dat de prompt 1.200 tokens is (regels plus idee) en het antwoord 1.800 tokens.

DeelTokensWiskundeKosten
Invoer1.2001.200 / 1.000.000 x $0,15$0.00018
Uitvoer1.8001,800 / 1,000,000 x $0,50$0,0009
Totaal3.000$0,00108

Dat is ongeveer een tiende cent per script. Een kanaal dat 1.000 scripts maakt, betaalt ongeveer $1,08 aan modelkosten. Retries en polijst-rondes verhogen dit, maar zelfs drie aanroepen per script houden het dicht bij een cent per stuk. Mislukte of geweigerde verzoeken worden niet in rekening gebracht. tegoed vervalt nooit, en de prijzenpagina geeft de opwaardeerbedragen, van $20 tot $500, en de bonusniveaus weer.

Het usage veld in elke response geeft exacte aantallen tokens, zodat je de echte kosten per script kunt loggen in plaats van schatten.

Limieten en gewoontes die tijd besparen

Een volledige sleutel staat 8 gelijktijdige verzoeken en 300 verzoeken per minuut toe. Een trialsleutel staat 2 gelijktijdige en 60 per minuut toe. Als je veel scripts batchgewijs verwerkt, gebruik dan een kleine worker pool van 4 tot 6 en back-off als je HTTP 429 ziet. De foutcode vertelt je welke limiet je raakte: rate_limited voor verzoeken per minuut, concurrency voor te veel tegelijk. Bij tijdelijke overbelasting bevat het antwoord een Retry-After: 5 header, dus wacht vijf seconden en probeer het opnieuw.

  • Bewaar elk script met zijn prompt, zodat je een goed er kunt reproduceren. Het seed parameter wordt doorgestuurd als je repeatable runs wilt.
  • Houd een stijlgids (verboden zinnen, terugkerende personagenamen, merktoon) in het system prompt en hergebruik het over video's heen.
  • Log X-Request-Id van elke response; het helpt als je support vraagt over een specifieke aanroep.
  • Lees elk script voordat je het publiceert. Het model schrijft vloeiende tekst, geen geverifieerde feiten.
import time

def call_with_retry(fn, tries=4):
    for i in range(tries):
        try:
            return fn()
        except Exception as e:
            if "429" in str(e) and i < tries - 1:
                time.sleep(5 * (i + 1))
                continue
            raise

Prompts worden niet gebruikt voor training. Seksuele inhoud met minderjarigen is niet toegestaan, hoe het ook wordt gepresenteerd.

Vragen en antwoorden

Kan deze API de video zelf maken?

Nee. Het genereert alleen tekst. Gebruik het voor scripts, shotlijsten, ondertiteling en voice-over tekst, en stuur die door naar de video- en stemtools die je al gebruikt.

Hoe lang kan een script zijn?

Het contextvenster is 100.000 tokens voor prompt en antwoord samen, en max_tokens is optioneel, dus zeer lange scripts passen. Voor alles langer dan een paar minuten levert een outline-pass gevolgd door scene-by-scene calls betere kwaliteit op.

Moet ik betalen om het uit te proberen?

Nee. Nieuwe gebruikers kunnen $0,50 aan gratis proeftegoed claimen met één klik op de API-sleutelpagina na het aanmaken van een account. Latere opwaarderingen gebeuren in crypto (USDT op TRC20 of USDC op Base).

Weigert het donkere of volwassen onderwerpen in verhalen?

Het model is afgestemd om te antwoorden zonder inhoudelijke weigeringen voor wettelijk volwassen gebruik. Inhoud met minderjarigen in een seksuele context is nooit toegestaan.

Je sleutel is nog maar één formulier verwijderd

Maak een account aan, kopieer de sleutel, pas de base URL aan. Dat is de hele setup.

API-sleutel aanvragen