InícioGuia
Atualizado
Como fazer uma IA escrever um roteiro: estrutura do prompt
Se você quer saber como fazer uma IA escrever um roteiro que você possa realmente filmar ou dublar, a resposta é estrutura: diga ao modelo para quem é o roteiro, qual a duração e qual formato a saída deve ter.


Pontos principais
- Dê ao modelo um papel, um comprimento em palavras, um tom e um formato de saída. Cada item ausente se torna um palpite.
- Roteiros curtos cabem em uma chamada. Os longos precisam de um esboço primeiro, depois chamadas ato por ato.
- Use temperatura em torno de 0,8 para rascunhos e menor para edições; defina sequências de parada se precisar de um fim rígido.
- A janela de 100.000 tokens contém um esboço completo mais todos os atos anteriores, então você raramente precisa de truques.
Sem necessidade de cartão. Após o cadastro, reivindique $0,50 de crédito de teste grátis com um clique (uma vez por pessoa).
Obter chave de APIA resposta curta: cinco partes no prompt
A maioria dos roteiros fracos vem de prompts fracos. Uma requisição como "escreva um roteiro sobre café" deixa o modelo escolher o tamanho, o tom, o formato e o ponto de vista. Forneça essas cinco partes:
- Propósito: o que o espectador deve sentir ou fazer no final.
- Público e tom: "novos pais, caloroso e um pouco cansado" funciona melhor do que "amigável".
- Comprimento: em palavras, porque os modelos contam palavras melhor do que segundos. Cerca de 150 palavras equivalem a um minuto de fala.
- Formato: roteiro, narração e visuais em duas colunas, ou narração simples.
- Restrições: coisas a evitar, nomes para manter, uma última linha obrigatória.
Aqui está a diferença na prática. Um prompt fraco: "Escreva um roteiro sobre sono." Um mais forte: "Escreva uma narração de 120 palavras para um vídeo de 50 segundos que persuade trabalhadores de escritório a parar de verificar e-mails na cama. Tom: suave, levemente engraçado. Comece com uma pergunta. Termine com uma ação concreta que eles possam fazer esta noite. Não mencione medicamentos." O segundo prompt custa cerca de quarenta tokens a mais e elimina a maioria das rodadas de reescrita. Trate as palavras extras como a edição mais barata que você já fará.
Esse é todo o método. O resto desta página mostra como convertê-lo em chamadas de API e como escaloná-lo quando o roteiro é longo. Se você só precisa de um teste rápido, a página de chave de API oferece a novas contas um pequeno crédito de teste.
Escolha um formato e diga isso
Os modelos copiam o formato que você mostra. Se você quer um roteiro de duas colunas, mostre uma linha. Um pequeno exemplo no prompt supera um parágrafo de descrição.
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."}
]
}'
A mesma solicitação funciona com qualquer cliente OpenAI assim que a base URL é https://api.aivideogenapi.com/v1. Detalhes sobre autenticação e campos estão na documentação.
Para roteiros de diálogo, nomeie os falantes no prompt e dê a cada um uma nota de voz de uma linha ("Mara: direta, frases curtas. Ilya: explica demais"). Sem isso, os personagens tendem a soar iguais a partir da segunda página.
Configurações que alteram o resultado
Alguns parâmetros importam mais do que o resto.
| Parâmetro | Usado para | Valor típico |
|---|---|---|
temperature | Variedade de redação | 0,7 a 0,9 para rascunhos, 0,3 a 0,5 para edições |
top_p | Remove palavras improváveis | 0,9 a 0,95; altere isso ou a temperatura, não ambos |
max_tokens | Limite rígido no comprimento da resposta | Opcional; defina-o quando quiser uma proteção contra saída infinita |
stop | Termina com um marcador | Por exemplo "FIM DA CENA" |
frequency_penalty | Reduz frases repetidas | 0,2 a 0,5 para roteiros longos |
seed | Rascunhos repetíveis | Qualquer inteiro |
São enviados ao modelo. Não espere saída idêntica da mesma semente após alterar o prompt em apenas uma palavra.
Roteiros curtos: uma chamada é suficiente
Um roteiro de 30 a 90 segundos tem algumas centenas de palavras. Envie uma solicitação com as cinco partes e peça um único rascunho. Depois, use uma segunda mensagem para edições, porque editar um rascunho funciona melhor do que regenerar do 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)
Observe a queda de temperatura na segunda chamada. As edições devem seguir instruções, não explorar. Se quiser ver o roteiro aparecer, adicione stream: true e imprima cada bloco conforme chega; o total de uso aparece no final do streaming. Uma solicitação em streaming ocupa um dos seus slots de concorrência até o fim, o que importa quando você executa vários rascunhos em paralelo. Uma chave completa permite 8 ao mesmo tempo.
Roteiros longos: esboço primeiro, depois atos
Peça 4.000 palavras de uma vez e o meio fica fraco: o modelo pressiona o final, repete ideias e esquece pequenos fatos. Um padrão melhor tem três etapas.
Etapa 1: o esboço
Solicite um esboço numerado com uma frase por cena, o propósito de cada cena e uma lista contínua de fatos que devem permanecer consistentes (nomes, locais, o que cada personagem sabe). Edite isso manualmente. É o lugar mais barato para corrigir uma história.
Etapa 2: ato por ato
Para cada ato, envie o esboço, as regras de estilo, um resumo curto dos atos anteriores e o texto completo do último ato. Peça apenas o próximo ato.
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
Etapa 3: a leitura final
Envie o roteiro completo de volta e peça uma lista de contradições e linhas repetidas, não uma reescrita. Corrija-os com edições direcionadas.
Usando a janela de 100.000 tokens
O prompt mais a resposta podem atingir 100.000 tokens, aproximadamente 70.000 palavras. Um esboço completo, um guia de estilo e cada ato concluído de um roteiro de longa-metragem cabem confortavelmente. Isso significa que você pode frequentemente pular resumos e apenas enviar a história inteira até agora, o que mantém pequenos detalhes intactos.
Duas cautelas. Primeiro, o custo cresce porque cada chamada reenvia o histórico. Segundo, prompts muito longos ainda funcionam melhor quando as instruções mais importantes estão no final, perto da solicitação. Coloque a tarefa atual por último, após o material de referência. A página sobre a janela de contexto entra mais em detalhes sobre como organizar entradas longas.
Verificação de preço para um roteiro de 10 minutos construído em atos: suponha que as chamadas totalizem 6.000 tokens de entrada e 4.000 tokens de saída. Isso é 6.000 / 1.000.000 x $0,15 = $0,0009 para entrada e 4.000 / 1.000.000 x $0,50 = $0,002 para saída, totalizando $0,0029. Os preços estão listados na página de preços.
Problemas comuns e soluções
- O roteiro está muito longo ou muito curto. Declare uma faixa de palavras e adicione um ponto de parada. Verifique a contagem de palavras no código e peça um corte com o número exato.
- Cada cena abre da mesma maneira. Adicione uma penalidade de frequência e uma linha como "Varie como as cenas começam; nunca abra duas cenas com um som ou um detalhe climático."
- O tom se desvia. Cole duas linhas de amostra da voz alvo na mensagem do sistema e diga ao modelo que elas são uma referência de estilo, não texto para reutilizar.
- Direções de palco vazam para a narração. Peça campos separados (modo JSON com
response_formatdefinido comojson_object) para que narração e visuais nunca compartilhem uma string. - HTTP 429. Você atingiu um limite. O código
rate_limitedsignifica muitas requisições por minuto,concurrencysignifica muitas ao mesmo tempo. Aguarde e tente novamente.
Mais guias
Perguntas e respostas
Quantas palavras devo solicitar por minuto de vídeo?
Planeje cerca de 150 palavras faladas por minuto em ritmo calmo. Clipes rápidos para redes sociais podem ultrapassar 170 palavras, então teste com uma locução real.
Devo gerar o roteiro inteiro em uma única requisição?
Para menos de cerca de 800 palavras, sim. Para roteiros mais longos, escreva um esboço primeiro e gere ato por ato, passando o esboço e o último ato a cada vez.
O modelo mantém memória entre as requisições?
Não. Cada requisição é independente, então você envia o histórico que deseja que ele veja na lista de mensagens.
Ele consegue escrever o roteiro de ficção madura ou sombria?
O modelo é ajustado para responder sem filtros de conteúdo para uso adulto legal. Conteúdo sexual envolvendo menores nunca é permitido.
Sua chave está a um formulário de distância
Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.