ES ▾
Obtener clave de API

InicioGuía

Actualizado

Generador de guiones de vídeo con IA basado en una API LLM

Un generador de guiones de vídeo con IA es un modelo de texto con un prompt adecuado alrededor. Esta guía muestra cómo construir uno en una API compatible con OpenAI, con una plantilla en Python y el coste real por guion.

Desenrollado de una tira de película desde una terminal, cada fotograma contiene un boceto de escena, representando la generación de guiones por API
Recipiente de vidrio llenándose con bloques brillantes mientras una flecha en bucle lo rodea, representando la ventana de contexto de un agente

Puntos clave

  1. La API solo escribe texto: guiones, listas de planos y voz en off. No renderiza vídeo.
  2. Pide JSON para que cada escena quede en un campo que tu editor o herramienta de vídeo pueda leer.
  3. Un script de 60 segundos con lista de planos cuesta alrededor de una décima de centavo a $0,15 y $0,50 por 1M de tokens.
  4. Mantén el breve, el tono y las escenas anteriores en el prompt; la ventana es de 100.000 tokens.

Sin tarjeta. Tras registrarte, reclama $0,50 de crédito de prueba gratis con un clic (una vez por persona).

Obtener clave de API

Lo que realmente hace un generador de guiones

Un generador de guiones de vídeo con IA toma una idea breve y devuelve el texto que necesita un vídeo: un gancho, escenas, narración, texto en pantalla y notas para visuales. El modelo hace la escritura. Tu código hace el resto: construye el prompt, lo envía, verifica la respuesta y entrega las partes a lo que genere las imágenes.

Esta API es solo de texto. No genera imágenes, audio ni video. Esto encaja bien con la tarea, porque el guion es la etapa donde la mayoría de los proyectos de video se estancan, y también es la etapa más barata de automatizar. Las imágenes y las voces provienen de otras herramientas que ya usas. El modelo, ejecutado por un proveedor independiente, está ajustado para responder sin filtros de contenido para uso adulto legal, lo cual es importante si tus guiones cubren ficción madura, terror, historias de crimen o humor oscuro. Si quieres ver el panorama completo de cómo el texto se integra en los flujos de trabajo de video, consulta la guía de API de video con IA.

Vale la pena pedir tres salidas en una sola llamada: el texto de voz en off (lo que dice el narrador), la lista de planos (lo que ve el espectador) y una estimación de tiempo por escena. Dividirlos en campos separados facilita los pasos posteriores.

Configura el cliente

El endpoint es compatible con OpenAI, por lo que funciona el SDK estándar. Obtén una clave en la página de clave de API, luego apunta el cliente a la URL base y usa el ID de 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)

La misma petición funciona en curl o Node con solo cambiar la URL base y la clave. Los detalles completos de los parámetros están en la documentación de API. Las cuentas nuevas pueden reclamar $0,50 de crédito de prueba con un clic en la página de claves, lo cual es suficiente para probar todo en este artículo muchas veces.

Una plantilla de prompt que devuelve escenas utilizables

Una petición vaga da guiones vagos. Una buena plantilla corrige cuatro cosas: la audiencia, la longitud, el tono y el formato de salida. Pon las reglas en el mensaje del sistema y la idea en el mensaje del usuario.

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

El modo JSON (response_format con json_object) mantiene la respuesta analizable. Aún así envuelve json.loads en un bloque try y reintenta una vez en caso de fallo, ya que cualquier modelo puede producir ocasionalmente una cadena rota. Una temperatura de 0.7 a 0.9 da redacción variada; bájala a 0.3 cuando necesites una estructura casi idéntica en un lote.

Verifica la longitud antes de confiar en ella

Los modelos son malos contando segundos. Una regla fiable es de aproximadamente 150 palabras habladas por minuto para un narrador tranquilo, un poco más para clips sociales rápidos. Después de cada llamada, cuenta las palabras en todos los campos de voz en off y compáralas con el objetivo.

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

Si el guion es demasiado largo, envía un segundo mensaje con los números reales: "La voz en off dura aproximadamente 78 segundos; recórtala a 60 sin perder el gancho." La retroalimentación concreta funciona mejor que "hazlo más corto". Mantén la primera respuesta en la lista de mensajes para que el modelo vea lo que escribió.

Listas de planos y voz en off como pasadas separadas

Para vídeos más largos, una llamada para todo se diluye. Usa dos pasadas en su lugar. Primero pide un esquema de títulos de escenas y objetivos de una línea. Luego genera cada escena en su propia llamada, pasando el esquema y la voz en off de la escena anterior para que el tono se mantenga.

  • Paso 1, esquema: 6 a 12 escenas, cada una con un objetivo y una duración aproximada.
  • Paso 2, escenas: voz en off y plano para una escena a la vez, con el esquema y las dos últimas escenas en contexto.
  • Paso 3, pulido: lee la voz en off completa y pide que se varíen las frases repetidas.

La ventana de contexto es de 100.000 tokens para prompt más respuesta, por lo que incluso un guion de documental de 20 minutos con su esquema completo cabe en una sola conversación. Sobre cómo se comporta la memoria en sesiones largas, la página sobre la ventana de contexto cubre los límites prácticos. El streaming (stream: true) es útil si muestras el guion a una persona mientras se escribe.

Cuánto cuesta un script

La tarifa es de $0,15 por 1M de tokens de entrada y $0,50 por 1M de tokens de salida, pagados desde crédito prepago. Toma un guion típico de 60 segundos con lista de planos. Supongamos que el prompt es de 1.200 tokens (reglas más idea) y la respuesta es de 1.800 tokens.

ParteTokensMatemáticaCosto
Entrada1.2001.200 / 1.000.000 x $0,15$0.00018
Salida1.8001.800 / 1.000.000 x $0,50$0.0009
Total3.000$0,00108

Eso es aproximadamente una décima de centavo por guion. Un canal que hace 1.000 guiones paga aproximadamente $1,08 en tarifas de modelo. Los reintentos y las pasadas de pulido añaden a esto, pero incluso tres llamadas por guion lo mantienen cerca de un centavo cada una. Las peticiones fallidas o rechazadas no se cobran. El crédito no caduca, y la página de precios lista las cantidades de recarga, desde $20 hasta $500, y las escalas de bonificación.

El campo usage en cada respuesta da los recuentos exactos de tokens, para que puedas registrar el coste real por guion en lugar de estimar.

Límites y hábitos que ahorran tiempo

Una clave completa permite 8 solicitudes concurrentes y 300 solicitudes por minuto. Una clave de prueba permite 2 concurrentes y 60 por minuto. Cuando procesas muchos guiones en lote, usa un grupo de trabajo pequeño de 4 a 6 y haz backoff cuando veas HTTP 429. El código de error te dice qué límite alcanzaste: rate_limited para solicitudes por minuto, concurrency para demasiadas a la vez. En sobrecarga temporal, la respuesta lleva un encabezado Retry-After: 5, así que espera cinco segundos y reintentá.

  • Guarda cada guion con su prompt para que puedas reproducir uno bueno. El parámetro seed se reenvía si quieres que las ejecuciones sean repetibles.
  • Mantén una hoja de estilo (frases prohibidas, nombres de personajes recurrentes, voz de marca) en el prompt del sistema y reutilízala en varios vídeos.
  • Registra X-Request-Id de cada respuesta; te ayuda cuando contactas a soporte sobre una llamada específica.
  • Lee cada guion antes de publicar. El modelo escribe texto fluido, no hechos 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

Los prompts no se usan para entrenamiento. El contenido sexual que involucre a menores de edad no está permitido, independientemente del contexto.

Preguntas y respuestas

¿Puede esta API generar el vídeo?

No. Solo genera texto. Úsalo para guiones, listas de planos, subtítulos y texto de voz en off, y pásalos a las herramientas de vídeo y voz que ya usas.

¿Qué tan largo puede ser un guion?

La ventana de contexto es de 100.000 tokens para el prompt y la respuesta juntos, y max_tokens es opcional, por lo que los guiones muy largos caben. Para cualquier cosa que supere unos pocos minutos, una pasada de esquema seguida de llamadas escena por escena da mejor calidad.

¿Necesito pagar para probarlo?

No. Los nuevos usuarios pueden reclamar $0,50 de crédito de prueba con un solo clic en la página de la clave de API después de registrarse. Los recargos posteriores se realizan con cripto (USDT en TRC20 o USDC en Base).

¿Rechazará temas de historias oscuras o maduras?

El modelo está ajustado para responder sin rechazos de contenido para uso adulto lícito. El contenido que involucre a menores de edad en un contexto sexual nunca está permitido.

Tu clave está a un formulario de distancia

Crea una cuenta, copia la clave, cambia la URL base. Esa es toda la configuración.

Obtener clave de API