PT ▾
Obter chave de API

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.

Blocos de notas vinculados a uma pilha de páginas de roteiro e uma claqueta, mostrando a escrita de roteiros com foco na estrutura
Recipiente de vidro enchendo com blocos brilhantes enquanto uma seta circular gira ao redor, ilustrando a janela de contexto de um agente

Pontos principais

  1. Dê ao modelo um papel, um comprimento em palavras, um tom e um formato de saída. Cada item ausente se torna um palpite.
  2. Roteiros curtos cabem em uma chamada. Os longos precisam de um esboço primeiro, depois chamadas ato por ato.
  3. 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.
  4. 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 API

A 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:

  1. Propósito: o que o espectador deve sentir ou fazer no final.
  2. Público e tom: "novos pais, caloroso e um pouco cansado" funciona melhor do que "amigável".
  3. Comprimento: em palavras, porque os modelos contam palavras melhor do que segundos. Cerca de 150 palavras equivalem a um minuto de fala.
  4. Formato: roteiro, narração e visuais em duas colunas, ou narração simples.
  5. 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âmetroUsado paraValor típico
temperatureVariedade de redação0,7 a 0,9 para rascunhos, 0,3 a 0,5 para edições
top_pRemove palavras improváveis0,9 a 0,95; altere isso ou a temperatura, não ambos
max_tokensLimite rígido no comprimento da respostaOpcional; defina-o quando quiser uma proteção contra saída infinita
stopTermina com um marcadorPor exemplo "FIM DA CENA"
frequency_penaltyReduz frases repetidas0,2 a 0,5 para roteiros longos
seedRascunhos repetíveisQualquer 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_format definido como json_object) para que narração e visuais nunca compartilhem uma string.
  • HTTP 429. Você atingiu um limite. O código rate_limited significa muitas requisições por minuto, concurrency significa muitas ao mesmo tempo. Aguarde e tente novamente.

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.

Obter chave de API