HomeGuida
Aggiornato
Come far scrivere una sceneggiatura a un'IA: struttura del prompt
Se vuoi sapere come far scrivere a un'IA una sceneggiatura che puoi effettivamente girare o doppiare, la risposta è la struttura: indica al modello per chi è la sceneggiatura, quanto dura e che forma deve avere l'output.


Punti chiave
- Assegna al modello un ruolo, una lunghezza in parole, un tono e un formato di output. Ogni elemento mancante diventa un'ipotesi.
- Le sceneggiature brevi si adattano a una singola chiamata. Quelle lunghe richiedono prima un'outline, poi chiamate atto per atto.
- Usa una temperatura intorno a 0.8 per le bozze e più bassa per le modifiche; imposta le sequenze di stop se ti serve una fine netta.
- La finestra da 100.000 token contiene un'outline completo più tutti gli atti precedenti, quindi raramente servono escamotage.
Nessuna carta necessaria. Dopo la registrazione, ottieni $0,50 di credito di prova gratuito con un clic (una volta per persona).
Ottieni la chiave APILa risposta breve: cinque parti nel prompt
La maggior parte delle sceneggiature deboli deriva da prompt deboli. Una richiesta come "scrivi una sceneggiatura sul caffè" lascia al modello la scelta della lunghezza, della voce, del formato e del punto di vista. Invece, fornisci queste cinque parti:
- Scopo: ciò che lo spettatore dovrebbe provare o fare alla fine.
- Pubblico e tono: "neogenitori, caldo e un po' stanco" funziona meglio di "amichevole".
- Lunghezza: in parole, perché i modelli contano meglio le parole rispetto ai secondi. Circa 150 parole corrispondono a un minuto di parlato.
- Formato: sceneggiatura, voce fuori campo e visivi a due colonne, o narrazione semplice.
- Vincoli: cose da evitare, nomi da mantenere, una riga finale obbligatoria.
Ecco la differenza in pratica. Un prompt debole: "Scrivi una sceneggiatura sul sonno." Uno più forte: "Scrivi una narrazione di 120 parole per un video di 50 secondi che persuada i lavoratori d'ufficio a smettere di controllare la posta nel letto. Tono: gentile. Inizia con una domanda. Finisci con un'azione concreta che possono fare stasera. Non menzionare farmaci." Il secondo prompt costa circa quaranta token in più e rimuove la maggior parte dei round di riscrittura. Tratta le parole extra come la revisione più economica che farai mai.
Questo è l'intero metodo. Il resto di questa pagina mostra come trasformarlo in chiamate API e come scalare quando la sceneggiatura è lunga. Se ti serve solo un test rapido, la pagina delle chiavi API offre ai nuovi account un piccolo credito di prova.
Scegli un formato e dillo
I modelli copiano il formato che gli mostri. Se vuoi una sceneggiatura a due colonne, mostrane una riga. Un piccolo esempio nel prompt batte un paragrafo di descrizione.
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."}
]
}'
La stessa richiesta funziona con qualsiasi client OpenAI una volta impostato il base URL su https://api.aivideogenapi.com/v1. I dettagli su autenticazione e campi sono nella documentazione.
Per le sceneggiature di dialogo, nomina i personaggi nel prompt e fornisci a ciascuno una nota vocale di una riga ("Mara: diretta, frasi brevi. Ilya: spiega troppo"). Senza di essa, i personaggi tendono a suonare simili dalla seconda pagina.
Impostazioni che cambiano il risultato
Alcuni parametri sono più importanti degli altri.
| Voce | Usalo per | Valore tipico |
|---|---|---|
temperature | Varietà del linguaggio | 0,7-0,9 per le bozze, 0,3-0,5 per le modifiche |
top_p | Elimina parole improbabili | 0,9-0,95; modifica questo o la temperatura, non entrambi |
max_tokens | Limite rigido alla lunghezza della risposta | Opzionale; impostalo quando vuoi una protezione contro output incontrollati |
stop | Fine su un marcatore | Ad esempio "FINE SCENA" |
frequency_penalty | Riduce le frasi ripetute | 0,2-0,5 per sceneggiature lunghe |
seed | Bozze ripetibili | Qualsiasi intero |
Questi vengono passati al modello. Non aspettarti output identici dallo stesso seed dopo aver modificato il prompt anche solo di una parola.
Sceneggiature brevi: una chiamata è sufficiente
Una sceneggiatura di 30-90 secondi è lunga poche centinaia di parole. Invia una singola richiesta con le cinque parti e chiedi una singola bozza. Poi usa un secondo messaggio per le modifiche, perché modificare una bozza funziona meglio che rigenerare da zero.
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)
Nota la diminuzione della temperatura nella seconda chiamata. Le modifiche dovrebbero seguire le istruzioni, non esplorare. Se vuoi vedere apparire la sceneggiatura, aggiungi stream: true e stampa ogni chunk al suo arrivo; i totali di utilizzo arrivano alla fine dello streaming. Una richiesta streaming occupa uno dei tuoi slot di concorrenza fino al termine, il che conta quando esegui più bozze in parallelo. Una chiave completa permette 8 chiamate simultanee.
Sceneggiature lunghe: prima l'outline, poi gli atti
Chiedi 4.000 parole in una volta e la parte centrale si affloscia: il modello affretta la fine, ripete idee e dimentica piccoli fatti. Un pattern migliore ha tre passaggi.
Fase 1: l'outline
Chiedi una scaletta numerata con una frase per scena, lo scopo di ogni scena e un elenco continuo di fatti che devono rimanere coerenti (nomi, luoghi, ciò che ogni personaggio sa). Modificalo a mano. È il punto più economico per correggere una storia.
Fase 2: atto per atto
Per ogni atto, invia l'outline, le regole di stile, un breve riassunto degli atti precedenti e il testo completo dell'ultimo atto. Chiedi solo l'atto successivo.
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
Fase 3: la lettura finale
Invia di nuovo la sceneggiatura completa e chiedi un elenco di contraddizioni e righe ripetute, non una riscrittura. Correggile con modifiche mirate.
Uso della finestra da 100.000 token
Prompt più risposta possono raggiungere 100.000 token, circa 70.000 parole. Una scaletta completa, una guida di stile e ogni atto finito di una sceneggiatura per lungometraggio si adattano comodamente. Questo significa che spesso puoi saltare i riassunti e inviare semplicemente tutta la storia finora, mantenendo intatti i piccoli dettagli.
Due avvertenze. Primo, il costo cresce perché ogni chiamata reinvia la cronologia. Secondo, i prompt molto lunghi funzionano comunque meglio quando le istruzioni più importanti sono alla fine, vicine alla richiesta. Metti il compito corrente per ultimo, dopo il materiale di riferimento. La pagina sulla finestra di contesto approfondisce come organizzare gli input lunghi.
Verifica del prezzo per uno script di 10 minuti suddiviso in atti: supponiamo che le chiamate totalizzino 6.000 token di input e 4.000 token di output. Questo significa 6.000 / 1.000.000 x $0,15 = $0,0009 per l'input e 4.000 / 1.000.000 x $0,50 = $0,002 per l'output, per un totale di $0,0029. I prezzi sono elencati nella pagina prezzi.
Problemi comuni e soluzioni
- Lo script è troppo lungo o troppo corto. Indica un intervallo di parole e aggiungi un punto di arresto. Controlla il conteggio delle parole nel codice e chiedi di ridurlo con il numero esatto.
- Ogni scena inizia allo stesso modo. Aggiungi una penalità di frequenza e una riga come "Varia come iniziano le scene; non aprire mai due scene con un suono o un dettaglio meteo."
- Il tono devia. Incolla due righe campione della voce target nel messaggio di sistema e indica al modello che sono un riferimento di stile, non testo da riutilizzare.
- Le indicazioni di regia trapelano nella narrazione. Chiedi campi separati (modalità JSON con
response_formatimpostato sujson_object) in modo che narrazione e visivi non condividano mai una stringa. - HTTP 429. Hai raggiunto un limite. Il codice
rate_limitedsignifica troppe richieste al minuto,concurrencysignifica troppe simultanee. Attendi e riprova.
Altre guide
Domande e risposte
Quante parole devo richiedere per ogni minuto di video?
Pianifica circa 150 parole pronunciate al minuto a un ritmo tranquillo. I clip social veloci possono raggiungere le 170 o più, quindi testa con una voce fuori campo reale.
Devo generare l'intero script in una singola richiesta?
Per meno di circa 800 parole, sì. Per script più lunghi, scrivi prima una scaletta e genera atto per atto, passando la scaletta e l'ultimo atto ogni volta.
Il modello mantiene una memoria tra le richieste?
No. Ogni richiesta è indipendente, quindi invii tu la cronologia che vuoi che veda nell'elenco dei messaggi.
Può scrivere script di narrativa dark o per adulti?
Il modello è tarato per rispondere senza rifiuti sui contenuti per l'uso adulto legale. I contenuti sessuali che coinvolgono minorenni non sono mai permessi.
La tua chiave è a un modulo di distanza
Crea un account, copia la chiave, modifica l'URL di base. È tutta la configurazione.