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.


Puntos clave
- 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.
- Los guiones cortos caben en una llamada. Los largos necesitan un esquema primero, luego llamadas acto por acto.
- Usa una temperatura alrededor de 0.8 para borradores y menor para ediciones; establece secuencias de parada si necesitas un final estricto.
- 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 APILa 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:
- Propósito: lo que el espectador debería sentir o hacer al final.
- Audiencia y tono: "padres primerizos, cálidos y un poco cansados" funciona mejor que "amigable".
- Longitud: en palabras, porque los modelos cuentan palabras mejor que segundos. Aproximadamente 150 palabras es un minuto de habla.
- Formato: guion cinematográfico, voz en off y visuales en dos columnas, o narración simple.
- 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 para | Valor típico |
|---|---|---|
temperature | Variedad de redacción | 0.7 a 0.9 para borradores, 0.3 a 0.5 para ediciones |
top_p | Recorta palabras improbables | 0.9 a 0.95; cambia esto o la temperatura, no ambos |
max_tokens | Tope duro en la longitud de la respuesta | Opcional; establécelo cuando quieras una protección contra salidas descontroladas |
stop | Termina con un marcador | Por ejemplo "FIN DE ESCENA" |
frequency_penalty | Reduce frases repetidas | 0.2 a 0.5 para guiones largos |
seed | Borradores repetibles | Cualquier 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_formatestablecido enjson_object) para que la narración y los visuales nunca compartan una cadena. - HTTP 429. Has alcanzado un límite. El código
rate_limitedsignifica demasiadas peticiones por minuto,concurrencysignifica demasiadas a la vez. Espera y reintenta.
Más guías
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.