PT ▾

API de Texto Unfiltered Video: um fluxo de trabalho LLM para scripts

Se você procurou por api de texto sem filtro para vídeo, a divisão útil é esta: seu renderizador gera os pixels, e uma API de texto LLM escreve tudo ao redor deles, desde roteiros e listas de tomadas até legendas e descrições. Este guia constrói essa parte textual em um endpoint compatível com OpenAI.

Atualizado

Tira de filme virando blocos de texto fluindo em um terminal, ilustrando um fluxo de trabalho de texto LLM para vídeo

Pontos principais

  • A API é apenas texto. Ela escreve roteiros, listas de tomadas, legendas e descrições; não renderiza vídeo, imagens ou áudio.
  • O streaming fornece um rascunho de roteiro enquanto é escrito, e o modo JSON fornece uma lista de tomadas que seu código pode analisar.
  • A janela de 100.000 tokens mantém uma transcrição longa mais suas instruções em uma única requisição.
  • Uma passagem completa de texto para um vídeo custa uma fração de centavo a $0,15 e $0,50 por 1M de tokens.

Onde o texto se encaixa em um pipeline de vídeo

A API deste site não gera vídeo. É apenas texto: sem saída de imagem, áudio ou vídeo, sem embeddings, sem ajuste fino. Isso importa porque a frase é lida de duas formas. Algumas pessoas querem um modelo que renderize clipes, e para isso você precisa de um modelo de vídeo separado. Outros já têm um renderizador, uma biblioteca de estoque ou um editor, e precisam de um LLM que escreva o texto ao redor sem recusar assuntos que são legais, mas desconfortáveis: roteiros de terror, recriações de crimes reais, comédia sombria, narração de documentários de guerra, ficção madura escrita para adultos.

O segundo grupo é para quem este artigo se destina. Na prática, o trabalho textual em torno de um vídeo divide-se em quatro tarefas:

  • Redação de roteiro. Transforme um esboço ou uma pilha de notas em narração com uma voz consistente.
  • Listas de tomadas. Divida um roteiro em cenas com duração, descrição visual e uma linha de narração cada, como JSON que seu código de edição pode ler.
  • Legendas e limpeza de legendas. Corrija pontuação e rótulos de locutores em uma transcrição bruta, ou escreva texto na tela.
  • Títulos, descrições e tags. Saídas curtas, muitas delas, o que é benéfico para você no preço por token.

O modelo por trás do endpoint é um modelo de pesos abertos executado por um provedor independente e ajustado para responder sem recusas de conteúdo para uso adulto legal. Não é um roteador entre fornecedores nem a API oficial de nenhum outro modelo. Uma limitação rígida se aplica: sem conteúdo sexual envolvendo menores de idade. Se você ainda está decidindo como as partes de áudio e vídeo da sua stack se encaixam, a página sobre pipelines de vídeo cobre a divisão de trabalho.

Conecte o cliente

O endpoint usa o formato de conclusão de chat da OpenAI, então qualquer SDK da OpenAI funciona após você alterar dois valores: a URL base e a chave. O ID do modelo é uncensored, e a autenticação é um token Bearer padrão. Existem dois métodos: POST /v1/chat/completions e GET /v1/models.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

# sanity check: the model list should include "uncensored"
print([m.id for m in client.models.list().data])
MODEL = "uncensored"

Se você prefere o shell, a mesma verificação é uma única requisição:

curl https://api.unfilteredvideo.com/v1/chat/completions \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"uncensored","messages":[{"role":"user","content":"Write a two-line cold open for a ghost-story video."}]}'

Você pode obter uma chave na página de chaves de API. Contas novas podem reivindicar $0,50 de crédito de teste com um clique, válido por 7 dias e sem necessidade de cartão, o que é suficiente para tudo abaixo.

Passo 1: transmitir um rascunho de roteiro

Um roteiro é a saída mais longa no pipeline, então é a que vale a pena transmitir. Com stream: true, o servidor envia tokens via SSE conforme são produzidos, e os números de uso chegam ao final do stream. Sua ferramenta de editor pode mostrar o rascunho crescendo em vez de travar por toda a geração.

from openai import OpenAI
import os

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

outline = """Cold open: abandoned lighthouse at night.
Act 1: the keeper's logbook, last entry torn out.
Act 2: the tide table that does not match the moon.
Close: the lamp turns on by itself."""

stream = client.chat.completions.create(
    model="uncensored",
    stream=True,
    temperature=0.9,
    messages=[
        {"role": "system", "content": "You write narration for short horror videos. Second person, present tense, about 90 seconds spoken."},
        {"role": "user", "content": outline},
    ],
)

script = []
for chunk in stream:
    if chunk.choices and chunk.choices[0].delta.content:
        piece = chunk.choices[0].delta.content
        script.append(piece)
        print(piece, end="", flush=True)
    if getattr(chunk, "usage", None):
        print("\n\ntokens:", chunk.usage.prompt_tokens, chunk.usage.completion_tokens)

script = "".join(script)

Dois detalhes são fáceis de perder. Primeiro, o último chunk pode conter uso e sem choices, por isso o loop verifica chunk.choices antes de indexar. Segundo, uma requisição em streaming mantém seu slot de concorrência até o fim do stream. Se sua ferramenta permite que usuários iniciem vários rascunhos ao mesmo tempo, conte cada stream aberto contra seu limite.

A voz é o que muda ao longo de uma série. Coloque as regras do canal na mensagem do sistema e mantenha-as fixas: pessoa e tempo do narrador, comprimento da frase, palavras a evitar, como um início frio deve terminar. Adicione uma lista curta de coisas que o roteiro nunca deve fazer, como explicar a reviravolta cedo. Uma mensagem de sistema estável também torna suas contagens de tokens previsíveis de um vídeo para o próximo, o que ajuda quando você faz o orçamento depois.

Para rascunhos repetíveis enquanto você ajusta um prompt, passe seed com um valor fixo e um temperature mais baixo. Para uma primeira passagem criativa, uma temperatura em torno de 0,8 a 1,0 dá uma narração mais solta e animada, e você pode reduzir depois que estiver refinando.

Passo 2: transformar o roteiro em uma lista de tomadas

O código de edição quer estrutura, não parágrafos. O modo JSON pede ao modelo para retornar um único objeto JSON, e você o habilita com response_format. Também diga a palavra JSON no seu prompt e descreva a forma que você quer; os dois juntos mantêm a saída na forma.

import json, os
from openai import OpenAI

client = OpenAI(api_key=os.environ["API_KEY"], base_url="https://api.unfilteredvideo.com/v1")

def shot_list(script_text):
    resp = client.chat.completions.create(
        model="uncensored",
        response_format={"type": "json_object"},
        temperature=0.3,
        messages=[
            {"role": "system", "content": (
                "Return JSON only: {\"shots\": [{\"n\": int, \"seconds\": number, "
                "\"visual\": string, \"narration\": string}]}. "
                "Keep each shot between 3 and 8 seconds."
            )},
            {"role": "user", "content": script_text},
        ],
    )
    data = json.loads(resp.choices[0].message.content)
    return data["shots"]

for s in shot_list(script):
    print(s["n"], s["seconds"], s["visual"][:60])

O modo JSON torna a saída ruim rara, não impossível. Envolva json.loads em um bloco try, tente novamente uma vez com uma temperatura mais baixa, e valide os campos dos quais você depende. Uma lista de tomadas com um valor seconds faltante quebrará uma timeline muito mais ruidosamente do que uma frase ligeiramente desajeitada.

Passe as strings visual para qualquer coisa que gere ou selecione seu material. Como o modelo não é pedido para ser cauteloso sobre o assunto, descrições de cenas sombrias ou tensas voltam como briefs escritos em vez de recusas educadas. Mantenha seu próprio passo de revisão no loop para qualquer coisa que você publicar.

Passo 3: legendas e descrições a partir de uma transcrição longa

A janela de contexto é de 100.000 tokens, prompt e conclusão juntos. Para trabalho de texto em vídeo, isso é generoso: uma transcrição longa de entrevista, o guia de estilo do seu canal e três descrições de exemplo cabem em uma única solicitação, então você não precisa dividir e costurar como faria com uma janela pequena. Verifique o tamanho real a partir do campo usage em vez de adivinhar, e deixe espaço para a saída.

import OpenAI from "openai";
import fs from "node:fs";

const client = new OpenAI({
  apiKey: process.env.API_KEY,
  baseURL: "https://api.unfilteredvideo.com/v1",
});

const transcript = fs.readFileSync("interview.txt", "utf8");

const res = await client.chat.completions.create({
  model: "uncensored",
  temperature: 0.4,
  messages: [
    { role: "system", content: "You write video metadata. Reply with a title under 70 characters, a 3 sentence description, and 8 tags separated by commas." },
    { role: "user", content: transcript },
  ],
});

console.log(res.choices[0].message.content);
console.log(res.usage);

Para limpeza de legendas, divida por tempo em vez de por tamanho. Envie alguns minutos de transcrição bruta de cada vez com a instrução para manter os timestamps intactos, depois mescle. Se você também precisa de legendas na tela que correspondam a um estilo de casa, coloque as regras de estilo na mensagem do sistema e mantenha-as idênticas entre chamadas; isso torna as saídas consistentes e torna a contagem de tokens previsível.

A chamada de funções também está disponível, se você quiser que o modelo chame suas próprias funções, por exemplo, uma função lookup_asset que verifica sua biblioteca de material para um clipe correspondente enquanto escreve a lista de tomadas. Defina as ferramentas, leia tool_calls da resposta, execute-as e envie os resultados de volta como mensagens role: "tool".

Limites que moldam o pipeline

Uma chave completa permite 8 requisições simultâneas e 300 requisições por minuto. Uma chave de teste permite 2 simultâneas e 60 por minuto. O limite do corpo é 8 MB, o que está muito acima de qualquer transcrição que você enviar como texto. Após um limite, você recebe HTTP 429 com o código de erro rate_limited (muitas por minuto) ou concurrency (muitas de uma vez). Em sobrecarga temporária, você também recebe um 429, com um cabeçalho Retry-After: 5.

A regra simples: em qualquer 429, aguarde o valor do cabeçalho se houver um, caso contrário, faça backoff por alguns segundos, depois tente novamente. Requisições falhas ou recusadas não são cobradas, então as tentativas não custam a você. As respostas incluem X-Request-Id para perguntas de suporte e X-Balance-USD, que é útil para mostrar o crédito restante dentro da sua própria ferramenta.

Quando você renderiza muitos vídeos em paralelo, dê à etapa textual seu próprio pool pequeno de 4 a 6 workers para que uma explosão de rascunhos não prive a etapa de lista de tomadas. O streaming conta contra a concorrência o tempo todo enquanto está aberto, então um usuário que abandona um rascunho parcialmente lido ainda segura um slot até que termine.

Quanto custa o lado textual de um vídeo

O preço é $0,15 por 1M de tokens de entrada e $0,50 por 1M de tokens de saída, a partir de crédito pré-pago sem assinatura. Aqui está uma passagem textual realista para um vídeo de 90 segundos, com a matemática mostrada:

EtapaTokens de entradaTokens de saídaCusto
Rascunho de roteiro6001,200600 × $0,15/1M = $0,00009, mais 1.200 × $0,50/1M = $0,0006, total $0,00069
Lista de tomadas1,500900$0.000225 + $0.00045 = $0.000675
Título, descrição, tags1,800300$0.00027 + $0.00015 = $0.00042

Os três passos somam $0,001785 por vídeo. Mil vídeos são $1,785 de texto. Mesmo que seus prompts reais sejam três vezes mais longos que estes, a escrita é a parte barata do trabalho. O crédito de teste de $0,50 sozinho cobre mais de 250 vídeos nestes tamanhos, já que $0,50 dividido por $0,001785 é cerca de 280.

Após o teste, o crédito vem de recargas de qualquer valor inteiro de $20 a $500, pagos em cripto (USDT na TRC20 ou USDC na Base). Bônus aplicam-se em recargas maiores: +5% de $50, +10% de $100, +15% de $200. O crédito nunca expira, e os prompts não são usados para treinamento. A página de preços lista os detalhes, e o início rápido tem o mesmo formato de requisição em alguns idiomas a mais.

Perguntas e respostas

Esta API gera vídeo?

Não. É apenas texto, sem geração de imagem, áudio ou vídeo. Use para roteiros, listas de tomadas, legendas e descrições e combine com o renderizador ou editor de sua escolha.

Ele recusa temas sombrios ou maduros?

O modelo é ajustado para responder sem recusas de conteúdo para uso adulto legal, então horror, crime e ficção madura para adultos são viáveis. Conteúdo sexual envolvendo menores de idade é uma recusa absoluta.

Qual ID de modelo e URL base eu uso?

Use o ID do modelo uncensored e a URL base https://api.unfilteredvideo.com/v1 com qualquer SDK compatível com OpenAI. Autentique-se com um token bearer.

Existe uma camada gratuita?

Não há plano gratuito. Usuários novos podem resgatar um crédito de teste único de $0,50, válido por 7 dias, sem cartão; depois disso, você recarrega a partir de $20.

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