API de texto Unfiltered Video: un flujo de trabajo LLM para guiones
Si buscaste "unfiltered video api text", la división útil es esta: tu renderizador genera los píxeles y una API de texto LLM escribe todo lo que los rodea, desde guiones y listas de planos hasta subtítulos y descripciones. Esta guía construye esa mitad de texto en un endpoint compatible con OpenAI.

Puntos clave
- La API es solo de texto. Escribe guiones, listas de planos, subtítulos y descripciones; no renderiza video, imágenes ni audio.
- El streaming te da un borrador de guion a medida que se escribe, y el modo JSON te da una lista de planos que tu código puede analizar.
- La ventana de 100.000 tokens contiene una transcripción larga más tus instrucciones en una sola petición.
- Un pase de texto completo para un video cuesta una fracción de centavo a $0.15 y $0.50 por 1M de tokens.
Dónde encaja el texto en un pipeline de video
La API de este sitio no genera video. Solo es texto: sin salida de imagen, audio ni video, sin embeddings ni ajuste fino. Esto importa porque la frase se lee de dos formas. Algunas personas quieren un modelo que renderice clips, y para eso necesitas un modelo de video separado. Otros ya tienen un renderizador, una biblioteca de stock o un editor, y necesitan un LLM que escriba el texto circundante sin rechazar temas lícitos pero incómodos: guiones de terror, recreaciones de crímenes reales, comedia oscura, narración de documentales de guerra, ficción madura para adultos.
El segundo grupo es para quien va dirigido este artículo. En la práctica, el trabajo de texto alrededor de un video se divide en cuatro tareas:
- Redacción de guiones. Convierte un esquema o un montón de notas en narración con una voz coherente.
- Listas de planos. Divide un guion en escenas con una duración, una descripción visual y una línea de narración cada una, en JSON que tu código de edición pueda leer.
- Subtítulos y limpieza de subtítulos. Corrige la puntuación y las etiquetas de hablante en una transcripción cruda, o escribe texto en pantalla.
- Títulos, descripciones y etiquetas. Salidas cortas y numerosas, donde el precio por token te favorece.
El modelo detrás del endpoint es un modelo de pesos abiertos gestionado por un proveedor independiente y ajustado para responder sin rechazos por contenido para uso adulto lícito. No es un enrutador entre proveedores ni la API oficial de ningún otro modelo. Hay un límite estricto: sin contenido sexual con menores de edad. Si aún estás decidiendo cómo encajan las mitades de audio y video de tu stack, la página sobre pipelines de video cubre la división del trabajo.
Conecta el cliente
El endpoint usa el formato de chat completions de OpenAI, por lo que cualquier SDK de OpenAI funciona tras cambiar dos valores: la base URL y la clave. El ID de modelo es uncensored, y la autenticación es un token bearer estándar. Existen dos métodos: POST /v1/chat/completions y 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"
Si prefieres la terminal, la misma verificación es una sola petición:
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."}]}'
Puedes obtener una clave en la página de claves de API. Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un clic, válido por 7 días y sin necesidad de tarjeta, lo cual es suficiente para todo lo siguiente.
Paso 1: transmitir un borrador de guion
Un guion es la salida más larga del pipeline, por lo que es la que merece transmitirse. Con stream: true el servidor envía tokens por SSE a medida que se producen, y los números de uso llegan al final del stream. Tu herramienta de edición puede mostrar el borrador creciendo en lugar de congelarse durante toda la generación.
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)
Dos detalles son fáciles de pasar por alto. Primero, el último fragmento puede contener uso y sin elecciones, por eso el bucle verifica chunk.choices antes de indexar. Segundo, una petición en streaming mantiene su ranura de concurrencia hasta que termina el stream. Si tu herramienta permite a los usuarios iniciar varios borradores a la vez, cuenta cada stream abierto contra tu límite.
La voz es lo que se desvía en una serie. Pon las reglas del canal en el mensaje del sistema y mantenlas fijas: persona y tiempo del narrador, longitud de las oraciones, palabras a evitar, cómo debe terminar un inicio en frío. Añade una lista corta de cosas que el guion nunca debe hacer, como explicar el giro antes de tiempo. Un mensaje del sistema estable también hace que tus conteos de tokens sean predecibles de un video a otro, lo cual ayuda al presupuestar después.
Para borradores repetibles mientras ajustas un prompt, pasa seed con un valor fijo y un temperature más bajo. Para una primera pasada creativa, una temperatura de 0,8 a 1,0 da una narración más suelta y animada, y puedes bajarla una vez que estés puliendo.
Paso 2: convertir el guion en una lista de planos
El código de edición quiere estructura, no párrafos. El modo JSON pide al modelo que devuelva un único objeto JSON, y lo habilitas con response_format. También di la palabra JSON en tu prompt y describe la forma que quieres; los dos juntos mantienen la salida en 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])
El modo JSON hace que las salidas malas sean raras, no imposibles. Envuelve json.loads en un bloque try, reintenta una vez con una temperatura más baja, y valida los campos en los que dependes. Una lista de planos con un valor seconds faltante romperá una línea de tiempo más ruidosamente que una oración ligeramente torpe.
Pasa las cadenas visual a cualquier generador o selector de material de video. Como no se le pide al modelo que sea cauteloso con el tema, las descripciones de escenas sombrías o tensas vuelven como resúmenes escritos en lugar de rechazos educados. Mantén tu propio paso de revisión en el proceso para cualquier cosa que publiques.
Paso 3: subtítulos y descripciones a partir de una transcripción larga
La ventana de contexto es de 100.000 tokens, prompt y completion juntos. Para el trabajo de texto en video esto es generoso: una transcripción de entrevista larga, la guía de estilo de tu canal y tres descripciones de ejemplo caben en una sola petición, así que no necesitas fragmentar y unir como harías con una ventana pequeña. Verifica el tamaño real desde el campo usage en lugar de adivinar, y deja espacio para la salida.
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 la limpieza de subtítulos, divide por tiempo en lugar de por tamaño. Envía unos minutos de transcripción cruda a la vez con la instrucción de mantener las marcas de tiempo intactas, luego une. Si también necesitas subtítulos en pantalla que coincidan con un estilo de casa, pon las reglas de estilo en el mensaje del sistema y mantenlas idénticas entre llamadas; esto hace que las salidas sean consistentes y hace predecible el conteo de tokens.
Las llamadas a funciones también están disponibles, si quieres que el modelo llame a tus propias funciones, por ejemplo una función lookup_asset que verifica tu biblioteca de material de archivo por un clip coincidente mientras escribe la lista de planos. Define las herramientas, lee tool_calls de la respuesta, ejecútalas y envía los resultados de vuelta como mensajes role: "tool".
Límites que moldean el pipeline
Una clave completa permite 8 peticiones simultáneas y 300 peticiones por minuto. Una clave de prueba permite 2 simultáneas y 60 por minuto. El límite del cuerpo es 8 MB, muy por encima de cualquier transcripción que envíes como texto. Al superar un límite recibes HTTP 429 con el código de error rate_limited (demasiadas por minuto) o concurrency (demasiadas a la vez). En sobrecarga temporal también recibes un 429, con un encabezado Retry-After: 5.
La regla simple: ante cualquier 429, espera el valor del encabezado si existe, de lo contrario retrocede por unos segundos, luego reintenta. Las peticiones fallidas o rechazadas no se cobran, por lo que los reintentos no te cuestan. Las respuestas incluyen X-Request-Id para preguntas de soporte y X-Balance-USD, útil para mostrar el crédito restante dentro de tu propia herramienta.
Cuando renderizas muchos videos en paralelo, dale a la etapa de texto su propio grupo de trabajo pequeño de 4 a 6 para que una ráfaga de borradores no prive por completo de recursos a la etapa de listas de planos. Los streams cuentan contra la concurrencia todo el tiempo que están abiertos, así que un usuario que abandone un borrador a medio leer aún mantiene un lugar hasta que termine.
Cuánto cuesta la parte de texto de un video
La tarifa es $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, desde crédito prepago sin suscripción. Aquí tienes una pasada de texto realista para un video de 90 segundos, con las matemáticas mostradas:
| Paso | Tokens de entrada | Tokens de salida | Costo |
|---|---|---|---|
| Borrador de guion | 600 | 1,200 | 600 × $0,15/1M = $0,00009, más 1.200 × $0,50/1M = $0,0006, total $0,00069 |
| Lista de planos | 1,500 | 900 | $0.000225 + $0.00045 = $0.000675 |
| Título, descripción, etiquetas | 1,800 | 300 | $0.00027 + $0.00015 = $0.00042 |
Los tres pasos suman $0,001785 por video. Mil videos equivalen a $1,785 en texto. Incluso si tus prompts reales son tres veces más largos que estos, la escritura es la parte económica del trabajo. Solo el crédito de prueba de $0,50 cubre más de 250 videos con estos tamaños, ya que $0,50 dividido por $0,001785 es aproximadamente 280.
Después de la prueba, el crédito proviene de recargas de cualquier monto entero de $20 a $500, pagados en cripto (USDT en TRC20 o USDC en Base). Los bonos aplican en recargas más grandes: +5% desde $50, +10% desde $100, +15% desde $200. El crédito no caduca y los prompts no se usan para entrenamiento. La página de precios detalla los detalles, y el inicio rápido tiene el mismo formato de petición en unos idiomas más.
Más guías
Preguntas y respuestas
¿Puede esta API generar video?
No. Solo es texto, sin generación de imágenes, audio ni video. Úsala para guiones, listas de planos, subtítulos y descripciones, y combínala con el renderizador o editor que prefieras.
¿Rechaza temas oscuros o maduros?
El modelo está ajustado para responder sin rechazos de contenido para uso adulto lícito, por lo que el horror, el crimen y la ficción madura para adultos son viables. El contenido sexual que involucre a menores de edad es un no rotundo.
¿Qué ID de modelo y URL base debo usar?
Usa el ID de modelo uncensored y la URL base https://api.unfilteredvideo.com/v1 con cualquier SDK compatible con OpenAI. Autentícate con un token Bearer.
¿Hay un nivel gratuito?
No hay un nivel gratuito. Los usuarios nuevos pueden reclamar un crédito de prueba único de $0.50, válido por 7 días, sin tarjeta; después recargas desde $20.
Tu clave está a un formulario de distancia
Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.