Guion de video
Envía un tema, un formato y una duración aproximada, y este endpoint devuelve un guion de vídeo estructurado: un gancho inicial pensado para sobrevivir los primeros tres segundos, una secuencia de bloques con ritmo, y una llamada a la acción de cierre. Está pensado para creadores, agencias y plataformas de contenido que producen vídeo a un ritmo que ningún redactor puede sostener solo.
Ejecútela online
Ejecute esto en nuestros servidores con su cuenta. Las herramientas gratuitas corren en su navegador; esta cobra de su saldo del KIT según el precio de arriba.
Por qué guion, y no solo un esquema
Muchas herramientas de guion se quedan en un esquema con viñetas, tres ideas y un vago 'cerrar el vídeo', y dejan la redacción real, la parte que decide si alguien sigue viendo, en manos de la persona. Este endpoint va más allá: redacta el gancho de apertura como una línea concreta, organiza el cuerpo en bloques con sentido de ritmo en vez de una lista plana, y escribe una llamada a la acción específica ligada al objetivo declarado, ya sea un seguimiento, un clic o una compra. La diferencia importa sobre todo en los primeros tres segundos, que es donde la mayoría del vídeo corto pierde a su audiencia antes incluso de presentar el tema.
Cómo funciona la solicitud
Se hace POST a /text/script con el tema, el formato objetivo (corto, largo, tutorial, etc.) y una duración aproximada. La tarea es asíncrona: recibe un task_id de inmediato y el guion terminado llega por webhook firmado o por un enlace firmado válido durante 24 horas, lo cual encaja de forma natural en un flujo de contenido que encola muchos guiones para un calendario de producción en vez de esperar uno a la vez.
El oficio que esto automatiza
La escritura de guiones para vídeo desciende de una disciplina mucho más antigua: la escritura para radio y televisión, construida alrededor de la misma restricción de sostener la atención en el tiempo, en lugar de permitir que la mirada del lector vuelva atrás a releer una frase, como sí lo permite el texto escrito. La estructura de gancho, bloques y llamada a la acción no es un truco; es la misma lógica estructural que los guionistas de radiodifusión han usado durante décadas, adaptada a un formato donde el espectador está a un toque de distancia de irse. Automatizarla bien significa respetar esa estructura en vez de producir un párrafo de prosa dividido arbitrariamente en escenas.
Dónde encaja en una línea de producción
Sirve para equipos de redes sociales que gestionan varios canales, agencias que escriben guiones para distintos clientes a la vez, y plataformas de contenido que permiten al usuario generar un primer borrador antes de que un editor humano lo revise. Como la entrega es asíncrona, una herramienta de calendario de contenido puede encolar los temas de toda una semana el lunes y recibir los borradores terminados durante el día vía webhook. El precio es $0.003 por solicitud más $0.0135 por guion, cobrado solo cuando el guion se completa; una generación fallida se reintenta automáticamente hasta tres veces sin costo.
Qué puede hacer con ella
Lote semanal de contenido
Un encargado de redes sociales encola diez temas el domingo por la noche y recibe diez guiones listos por webhook antes de la reunión de planificación del lunes.
Agencia con varios clientes
Una agencia que escribe guiones para cinco marcas a la vez genera cada uno en el formato y duración propios de la marca, sin que un redactor parta de cero por cada cliente.
Modo primer borrador en herramientas para creadores
Una app de edición de vídeo ofrece un botón de 'generar guion' que devuelve un borrador con gancho, bloques y llamada a la acción que el creador puede reescribir con su propio estilo antes de grabar.
Producción de cursos y tutoriales
Una plataforma educativa convierte el esquema de una lección en un guion de tutorial con ritmo, para que los instructores graben con estructura en vez de improvisar.
Preguntas frecuentes
¿Es gratis la API para generar guiones de vídeo?
No hay capa gratuita: las capas gratis se abusan y ralentizan a todos. El acceso funciona con un saldo prepago de ForHosting KIT: se recarga desde $10.00 (no caduca) y cada solicitud se cobra a su precio publicado, así que una llamada sin saldo devuelve HTTP 402. Sin suscripción, sin tokens ni créditos inventados, y una tarea fallida no se cobra.
¿Escribe un guion completo o solo un esquema?
Un guion completo y estructurado: gancho de apertura, bloques con ritmo y llamada a la acción de cierre, no solo viñetas para que usted las desarrolle.
¿Puedo definir la duración o el formato del vídeo?
Sí, envíe el formato objetivo y la duración aproximada junto con el tema, y el guion se ajusta a ese ritmo, ya sea para un clip corto o un tutorial más largo.
¿Cómo se entrega el resultado?
Por webhook firmado, recomendado para flujos de contenido automatizados, o por un enlace firmado válido durante 24 horas si prefiere consultarlo cuando lo necesite.
¿Puedo generar guiones para varios temas a la vez?
Sí: cada llamada a /text/script es una tarea asíncrona independiente, así que una herramienta de calendario de contenido puede encolar muchos temas en paralelo.
¿La llamada a la acción se ajusta a mi objetivo?
Indique el objetivo (seguimiento, clic, compra, suscripción) en la solicitud y el bloque de cierre se escribe hacia esa acción específica en vez de una despedida genérica.
¿En qué idiomas se puede generar el guion?
El guion sigue el idioma del tema y las instrucciones que envíe; no hay un parámetro de idioma separado que configurar.
¿Se conservan mis datos del tema o se usan para entrenamiento?
No: se eliminan al terminar el periodo de retención y nunca se usan para entrenar nada; el endpoint solo existe para generar su guion.
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, y pronto desde nuestra app, el email y Telegram.
Llámela desde su stack
curl -X POST https://api.kit.forhosting.com/text/script \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/script", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"input": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/script",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"input": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/script", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"input":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"input":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/script", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Ejemplo de solicitud
{
"input": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.script",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_tokens | 20000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
422 | task_failed | La tarea falló tras 3 reintentos. No se cobra. |