Generar titulares
El titular es lo único que la mayoría de la gente realmente lee de un artículo, y escribir diez buenos a mano es un trabajo lento que se repite todos los días. Este endpoint toma un tema o un borrador y devuelve varias variantes de titular distintas, pensadas para captar la mirada sin recurrir a promesas que luego el contenido no cumple.
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.
Pensado para el ritmo diario de publicar
Editores, encargados de crecimiento y bloggers independientes se topan con el mismo muro: el artículo está listo pero el titular es ese último cinco por ciento que consume una hora de dudas. text.headline existe para ese momento exacto. Envíe el cuerpo del artículo, un resumen o solo un título provisional, y recibe un conjunto de enfoques alternativos — directo, con curiosidad, con números, en forma de pregunta — para que elija en lugar de quedarse mirando la pantalla en blanco.
Qué ocurre realmente al llamar al endpoint
La llamada es asíncrona: se hace un POST a /text/headline, se recibe un task_id de inmediato y el modelo trabaja en segundo plano. Cuando termina, entrega el conjunto completo de variantes ya sea enviado a su URL de webhook o disponible en un enlace firmado válido por 24 horas. No hay que hacer sondeo constante ni interpretar respuestas parciales a mitad de la generación.
Una breve historia del titular como oficio
Escribir titulares es una disciplina propia desde la prensa popular de la década de 1830, que descubrió que una línea potente vendía periódicos en la calle antes de que nadie leyera una palabra adentro. La publicación digital heredó esa presión y la multiplicó: hoy la misma frase compite en un feed contra video, anuncios y cientos de otros titulares en apenas dos segundos de atención. El oficio no cambió; lo que creció por órdenes de magnitud es el volumen necesario para competir, y ahí es exactamente donde entra la automatización.
Calidad sin caer en la trampa del clickbait
Las variantes se generan apegadas al contenido de origen que proporciona — el modelo no inventa afirmaciones, cifras ni urgencia que no estén en su entrada. Si su borrador dice que una función ahorra diez minutos, el titular no lo va a inflar a 'ahorra horas'. Esa disciplina importa porque un titular es una promesa, y las promesas rotas son lo que hunde las métricas de participación con el tiempo, no el hecho de vender de menos.
Cómo encaja en un flujo más grande
Como el endpoint es asíncrono y funciona con webhook, se integra sin fricción en un hook de publicación de un CMS, un script de armado de newsletter o una cola de pruebas A/B que necesita cinco titulares candidatos antes de poder empezar. Combínelo con nuestro endpoint de variantes A/B cuando quiera probar el titular ganador contra distintos subtítulos o llamadas a la acción en el mismo lanzamiento.
Qué puede hacer con ella
Presión de cierre en una redacción
Un editor pega el borrador final diez minutos antes de publicar y recibe cinco opciones de titular en lugar de dejar pasar sin cambios el título provisional del redactor.
Asuntos de correo para newsletter
Un script semanal envía el resumen de la edición al endpoint y coloca la mejor variante directamente en el campo de asunto antes del envío.
Renovación de SEO en el blog
Un equipo de contenido regenera titulares para publicaciones antiguas que posicionan bien pero rinden poco en clics, sin reescribir los artículos.
Lotes para redes sociales
Un programador de publicaciones pide varias variantes cortas por artículo para rotar entre plataformas y que el mismo enlace no luzca idéntico en todas partes.
Preguntas frecuentes
¿Cómo funciona la api para generar titulares?
Envía una solicitud POST a /text/headline con su texto de origen o tema, recibe un task_id de inmediato y obtiene los titulares terminados por webhook o por un enlace firmado válido por 24 horas cuando el procesamiento concluye.
¿Hay un plan gratuito para generar titulares?
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.
¿Cuántas variantes de titular entrega una solicitud?
Usted define cuántas variantes quiere en la solicitud; la tarifa base es fija y cada variante adicional se cobra a $0.0135, así que solo paga por lo que realmente genera.
¿Los titulares serán clickbait?
No. Las variantes se mantienen fieles al contenido que envía y evitan urgencia fabricada o cifras que no estén en su entrada, para que el titular coincida con lo que el lector realmente encuentra.
¿Puedo usarlo en idiomas distintos al inglés?
Envíe su contenido de origen en el idioma en que quiera el titular; el endpoint no está limitado al inglés y genera variantes en el idioma de su entrada.
¿Qué pasa si la tarea falla?
Las generaciones fallidas se reintentan automáticamente hasta tres veces; si todos los reintentos fallan, recibe un error claro y nunca se le cobra por esa tarea.
¿Cuánto tiempo está disponible el resultado después del procesamiento?
Si usa el enlace firmado en lugar del webhook, permanece válido por 24 horas, después de lo cual el resultado se elimina junto con sus datos de entrada.
¿Puedo generar titulares en lote para todo un archivo?
Sí — encole una tarea asíncrona por artículo; como cada llamada devuelve un task_id de inmediato, puede lanzar cientos de solicitudes y recolectar los resultados conforme llegan los webhooks.
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/headline \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/headline", {
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/headline",
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/headline", 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/headline", 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.headline",
"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. |