PT ▾
Obter chave de API

InícioGuia

Atualizado

Gerador de Roteiro de Vídeo com IA Baseado em API LLM

Um gerador de roteiro de vídeo com IA é um modelo de texto com um bom prompt ao redor. Este guia mostra como construir um em uma API compatível com OpenAI, com um template Python e o custo real por roteiro.

Desenrolar uma fita de filme a partir de um terminal, cada quadro contendo um esboço de cena, representando a geração de roteiro por API
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. A API escreve apenas texto: roteiros, listas de tomadas e narração. Ela não renderiza vídeo.
  2. Peça JSON para que cada cena seja entregue em um campo que seu editor ou ferramenta de vídeo possa ler.
  3. Um roteiro de 60 segundos com lista de tomadas custa cerca de um décimo de centavo a $0.15 e $0.50 por 1M de tokens.
  4. Mantenha o resumo, o tom e as cenas anteriores no prompt; a janela é de 100.000 tokens.

Sem necessidade de cartão. Após o cadastro, resgate $0,50 de crédito de teste grátis com um clique (uma vez por pessoa).

Obter chave de API

O que um gerador de roteiros realmente faz

Um gerador de roteiros de vídeo com IA recebe uma ideia curta e retorna o texto necessário para o vídeo: um gancho, cenas, narração, texto na tela e notas para visuais. O modelo faz a escrita. Seu código faz o resto: ele constrói o prompt, envia, verifica a resposta e entrega as partes para qualquer ferramenta que gere as imagens.

Esta API é apenas de texto. Ela não gerará imagens, áudio ou vídeo. Isso se encaixa bem no trabalho, pois o roteiro é a etapa em que a maioria dos projetos de vídeo trava, e também é a etapa mais barata de automatizar. Imagens e vozes vêm de outras ferramentas que você já usa. O modelo, executado por um provedor independente, é ajustado para responder sem recusas de conteúdo para uso adulto legal, o que é importante se seus roteiros cobrirem ficção madura, terror, histórias de crime ou humor sombrio. Se você quiser uma visão mais ampla de como o texto se encaixa em pipelines de vídeo, consulte o guia de API de vídeo com IA.

Vale a pena pedir três saídas em uma única chamada: o texto de narração (o que o narrador diz), a lista de tomadas (o que o espectador vê) e uma estimativa de tempo por cena. Dividi-los em campos separados torna as etapas posteriores simples.

Configure o cliente

O endpoint é compatível com OpenAI, então o SDK padrão funciona. Obtenha uma chave na página da chave de API, aponte o cliente para a URL base e use o ID do modelo 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)

A mesma solicitação funciona em curl ou Node com apenas a URL base e a chave alteradas. Os detalhes completos dos parâmetros estão na documentação da API. Contas novas podem resgatar $0,50 de crédito de teste com um clique na página da chave, o suficiente para testar tudo neste artigo várias vezes.

Um modelo de prompt que retorna cenas utilizáveis

Uma solicitação vaga gera roteiros vagos. Um bom modelo corrige quatro coisas: o público-alvo, o comprimento, o tom e o formato de saída. Coloque as regras na mensagem do sistema e a ideia na mensagem do usuário.

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"])

O modo JSON (response_format com json_object) mantém a resposta analisável. Ainda assim, envolva json.loads em um bloco try e tente novamente uma vez em caso de falha, já que qualquer modelo pode ocasionalmente produzir uma string inválida. Uma temperatura de 0,7 a 0,9 oferece variações de redação; reduza para 0,3 quando precisar de estrutura quase idêntica em um lote.

Verifique o comprimento antes de confiar

Os modelos são ruins para estimar a duração. Uma regra confiável é de cerca de 150 palavras faladas por minuto para um narrador calmo, um pouco mais para clipes rápidos de redes sociais. Após cada chamada, conte as palavras em todos os campos de narração e compare-as com o alvo.

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.")

Se o roteiro estiver muito longo, envie uma segunda mensagem com os números reais: "A narração dura cerca de 78 segundos; corte para 60 sem perder o gancho." Feedback concreto funciona melhor do que "torne-o mais curto". Mantenha a primeira resposta na lista de mensagens para que o modelo veja o que escreveu.

Listas de tomadas e narração como etapas separadas

Para vídeos mais longos, uma chamada para tudo fica fraca. Use duas etapas em vez disso. Primeiro, peça um esboço de títulos de cena e objetivos de uma linha. Depois, gere cada cena em sua própria chamada, passando o esboço e a narração da cena anterior para que o tom se mantenha.

  • Etapa 1, esboço: 6 a 12 cenas, cada uma com um objetivo e uma duração aproximada.
  • Etapa 2, cenas: narração e tomada para uma cena de cada vez, com o esboço e as duas últimas cenas no contexto.
  • Etapa 3, polimento: leia a narração completa de volta e peça para que frases repetidas sejam variadas.

A janela de contexto é de 100.000 tokens para prompt mais resposta, então até um roteiro de documentário de 20 minutos com seu esboço completo cabe em uma única conversa. Para saber como a memória se comporta em sessões longas, a página sobre a janela de contexto cobre os limites práticos. Streaming (stream: true) é útil se você mostrar o roteiro a uma pessoa conforme ele é escrito.

Quanto custa um script

O preço é $0.15 por 1M de tokens de entrada e $0.50 por 1M de tokens de saída, pagos com crédito pré-pago. Pegue um roteiro típico de 60 segundos com uma lista de tomadas. Digamos que o prompt tenha 1,200 tokens (regras mais ideia) e a resposta tenha 1,800 tokens.

ParteTokensMatemáticaCusto
Entrada1,2001,200 / 1,000,000 x $0.15$0.00018
Saída1,8001,800 / 1,000,000 x $0.50$0.0009
Total3,000$0.00108

Isso é cerca de um décimo de centavo por roteiro. Um canal que faz 1.000 roteiros paga cerca de $1,08 em taxas de modelo. Retrabalhos e ajustes de polimento adicionam a isso, mas mesmo três chamadas por roteiro mantêm o custo próximo de um centavo cada. Requisições falhas ou recusadas não são cobradas. O crédito nunca expira, e a página de preços lista os valores de recarga, de $20 a $500, e os níveis de bônus.

O campo usage em cada resposta fornece contagens exatas de tokens, para que você possa registrar o custo real por roteiro em vez de estimar.

Limites e hábitos que economizam tempo

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de teste permite 2 requisições simultâneas e 60 por minuto. Ao processar muitos roteiros em lote, use um grupo de workers pequeno de 4 a 6 e reduza a velocidade quando vir HTTP 429. O código de erro indica qual limite você atingiu: rate_limited para requisições por minuto, concurrency para muitas requisições ao mesmo tempo. Em sobrecarga temporária, a resposta contém o cabeçalho Retry-After: 5, então aguarde cinco segundos e tente novamente.

  • Salve cada roteiro com seu prompt, para que você possa reproduzir um bom roteiro. O parâmetro seed é passado adiante se você quiser execuções repetíveis.
  • Mantenha uma folha de estilo (frases proibidas, nomes de personagens recorrentes, voz da marca) no prompt do sistema e reutilize-a em vários vídeos.
  • Registre X-Request-Id de cada resposta; isso ajuda quando você solicita suporte sobre uma chamada específica.
  • Leia cada roteiro antes de publicar. O modelo escreve texto fluido, não fatos verificados.
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 não são usados para treinamento. Conteúdo sexual envolvendo menores de idade não é permitido, independentemente do enquadramento.

Perguntas e respostas

Esta API pode gerar o vídeo em si?

Não. Ela gera apenas texto. Use-a para roteiros, listas de tomadas, legendas e texto de narração, e envie esses dados para as ferramentas de vídeo e voz que você já utiliza.

Quão longo pode ser um roteiro?

A janela de contexto é de 100.000 tokens para o prompt e a resposta combinados, e max_tokens é opcional, então roteiros muito longos cabem. Para qualquer coisa com mais de alguns minutos, uma etapa de esboço seguida de chamadas cena por cena oferece melhor qualidade.

Preciso pagar para experimentar?

Não. Novos usuários podem obter $0,50 de crédito de teste com um clique na página da chave de API após entrar. Recargas posteriores são feitas em cripto (USDT na TRC20 ou USDC na Base).

Ele recusará temas de histórias sombrias ou maduras?

O modelo é ajustado para responder sem recusas de conteúdo para uso adulto legal. Conteúdo envolvendo menores de idade em contexto sexual nunca é permitido.

Sua chave está a um passo de distância

Crie uma conta, copie a chave e altere a URL base. Essa é toda a configuração.

Obter chave de API