ES ▾
Obtener clave de API

InicioGuía

Actualizado

Cómo hacer que una IA escriba un guion: estructura del prompt

Si quieres saber cómo hacer que una IA escriba un guion que puedas filmar o narrar realmente, la respuesta es la estructura: dile al modelo para quién es el guion, cuánto dura y qué forma debe tener la salida.

Fichas de notas enlazadas que llevan a una pila de páginas de guion y una claqueta, mostrando la escritura de guiones primero con el esquema
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. Dale al modelo un rol, una longitud en palabras, un tono y un formato de salida. Cada elemento faltante se convierte en una suposición.
  2. Los guiones cortos caben en una llamada. Los largos necesitan un esquema primero, luego llamadas acto por acto.
  3. Usa una temperatura alrededor de 0.8 para borradores y menor para ediciones; establece secuencias de parada si necesitas un final estricto.
  4. La ventana de 100.000 tokens contiene un esquema completo más todos los actos anteriores, así que rara vez necesitas trucos.

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

Obtener clave de API

La respuesta corta: cinco partes en el prompt

La mayoría de los guiones débiles provienen de prompts débiles. Una petición como "escribe un guion sobre café" deja que el modelo elija la longitud, el tono, el formato y el punto. En su lugar, dale estas cinco partes:

  1. Propósito: lo que el espectador debería sentir o hacer al final.
  2. Audiencia y tono: "padres primerizos, cálidos y un poco cansados" funciona mejor que "amigable".
  3. Longitud: en palabras, porque los modelos cuentan palabras mejor que segundos. Aproximadamente 150 palabras es un minuto de habla.
  4. Formato: guion cinematográfico, voz en off y visuales en dos columnas, o narración simple.
  5. Restricciones: cosas a evitar, nombres a mantener, una línea final requerida.

Aquí tienes la diferencia en la práctica. Un prompt débil: "Escribe un guion sobre el sueño". Uno más sólido: "Escribe una narración de 120 palabras para un video de 50 segundos que convenza a los oficinistas de dejar de revisar el correo electrónico en la cama. Tono: suave, ligeramente divertido. Abre con una pregunta. Termina con una acción concreta que puedan tomar esta noche. No menciones medicamentos". El segundo prompt cuesta unos 40 tokens más y elimina la mayoría de las rondas de reescritura. Trata las palabras extra como la edición más barata que harás jamás.

Ese es todo el método. El resto de esta página muestra cómo convertirlo en llamadas a API, y cómo escalarlo cuando el guion es largo. Si solo necesitas una prueba rápida, la página de clave de API da a las nuevas cuentas un pequeño crédito de prueba.

Elige un formato y dilo

Los modelos copian el formato que les muestras. Si quieres un guion de dos columnas, muestra una fila. Un pequeño ejemplo en el prompt supera un párrafo de descripción.

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."}
    ]
  }'

La misma petición funciona con cualquier cliente de OpenAI una vez que la base URL es https://api.aivideogenapi.com/v1. Los detalles sobre autenticación y campos están en la documentación.

Para guiones de diálogo, nombra a los hablantes en el prompt y dale a cada uno una nota de voz de una línea ("Mara: directa, oraciones cortas. Ilya: explica en exceso"). Sin esto, los personajes tienden a sonar igual desde la página dos.

Ajustes que cambian el resultado

Algunos parámetros importan más que el resto.

ParámetroÚsalo paraValor típico
temperatureVariedad de redacción0.7 a 0.9 para borradores, 0.3 a 0.5 para ediciones
top_pRecorta palabras improbables0.9 a 0.95; cambia esto o la temperatura, no ambos
max_tokensTope duro en la longitud de la respuestaOpcional; establécelo cuando quieras una protección contra salidas descontroladas
stopTermina con un marcadorPor ejemplo "FIN DE ESCENA"
frequency_penaltyReduce frases repetidas0.2 a 0.5 para guiones largos
seedBorradores repetiblesCualquier entero

Estos se pasan al modelo. No esperes una salida idéntica con la misma semilla después de cambiar el prompt incluso en una palabra.

Guiones cortos: una llamada es suficiente

Un guion de 30 a 90 segundos son unas pocas cientos de palabras. Envía una petición con las cinco partes y pide un único borrador. Luego usa un segundo mensaje para ediciones, porque editar un borrador funciona mejor que regenerar desde cero.

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)

Observa la caída de la temperatura en la segunda petición. Las ediciones deben seguir las instrucciones, no explorar. Si quieres ver aparecer el guion, añade stream: true e imprime cada fragmento a medida que llega; los totales de uso aparecen al final del stream. Una petición en streaming ocupa una de tus ranuras concurrentes hasta que termina, lo cual importa cuando ejecutas varios borradores en paralelo. Una clave completa permite 8 a la vez.

Guiones largos: esquema primero, luego actos

Pide 4,000 palabras de una sola vez y la parte central se hunde: el modelo se apresura en el final, repite ideas y olvida pequeños detalles. Un patrón mejor tiene tres pasos.

Paso 1: el esquema

Pide un esquema numerado con una oración por escena, el propósito de cada escena y una lista continua de hechos que deben permanecer consistentes (nombres, lugares, lo que sabe cada personaje). Edita esto a mano. Es el lugar más barato para corregir una historia.

Paso 2: acto por acto

Para cada acto, envía el esquema, las reglas de estilo, un resumen corto de actos anteriores y el texto completo del último acto. Pide solo el siguiente acto.

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

Paso 3: la lectura completa

Envía el guion completo de vuelta y pide una lista de contradicciones y líneas repetidas, no una reescritura. Corrige eso con ediciones dirigidas.

Usando la ventana de 100.000 tokens

El prompt más la respuesta puede alcanzar 100.000 tokens, aproximadamente 70.000 palabras. Un esquema completo, una guía de estilo y cada acto terminado de un guion de largometraje caben cómodamente. Eso significa que a menudo puedes saltar los resúmenes y simplemente enviar toda la historia hasta ahora, lo que mantiene los pequeños detalles intactos.

Dos precauciones. Primero, el costo crece porque cada llamada reenvía el historial. Segundo, los prompts muy largos aún funcionan mejor cuando las instrucciones que más importan están al final, cerca de la petición. Pon la tarea actual al final, después del material de referencia. La página sobre la ventana de contexto entra más en detalle sobre cómo organizar entradas largas.

Comprobación de precio para un guion de 10 minutos construido en actos: supongamos que las peticiones suman 6.000 tokens de entrada y 4.000 tokens de salida. Eso es 6.000 / 1.000.000 x $0,15 = $0,0009 para la entrada y 4.000 / 1.000.000 x $0,50 = $0,002 para la salida, por lo tanto $0,0029 en total. Los precios se muestran en la página de precios.

Problemas comunes y soluciones

  • El guion es demasiado largo o demasiado corto. Establece un rango de palabras y añade un punto de parada. Verifica el conteo de palabras en código y pide un recorte con el número exacto.
  • Cada escena abre de la misma manera. Añade una penalización de frecuencia y una línea como "Varía cómo comienzan las escenas; nunca abras dos escenas con un sonido o un detalle del clima."
  • El tono se desvía. Pega dos líneas de muestra de la voz objetivo en el mensaje del sistema y dile al modelo que son una referencia de estilo, no texto para reutilizar.
  • Las acotaciones se filtran en la narración. Pide campos separados (modo JSON con response_format establecido en json_object) para que la narración y los visuales nunca compartan una cadena.
  • HTTP 429. Has alcanzado un límite. El código rate_limited significa demasiadas peticiones por minuto, concurrency significa demasiadas a la vez. Espera y reintenta.

Preguntas y respuestas

¿Cuántas palabras debo pedir por minuto de vídeo?

Planifica unas 150 palabras habladas por minuto a un ritmo tranquilo. Los clips sociales rápidos pueden alcanzar 170 o más, así que prueba con una voz en off real.

¿Debo generar todo el guión en una sola petición?

Para menos de unas 800 palabras, sí. Para guiones más largos, escribe primero un esquema y genera acto por acto, pasando el esquema y el último acto cada vez.

¿El modelo guarda memoria entre peticiones?

No. Cada petición es independiente, así que envías el historial que quieres que vea en la lista de mensajes.

¿Puede escribir guiones de ficción oscura o madura?

El modelo está ajustado para responder sin rechazos de contenido para uso adulto legal. El contenido sexual que involucre a menores de edad 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