Generar hilos
Un artículo tiene un solo argumento que corre de principio a fin; un hilo, en cambio, tiene que funcionar como una secuencia de publicaciones independientes que cada una se gane el toque hacia la siguiente. Este endpoint divide un texto largo en esa secuencia sin que las publicaciones del medio se sientan de relleno.
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é un artículo no se corta en hilo sin más
El enfoque obvio —cortar un artículo cada cierto número de caracteres— produce un hilo donde la tercera publicación no tiene sentido sin la segunda, la quinta no tiene gancho propio, y todo el conjunto se lee como un documento interrumpido en vez de un hilo pensado para leerse una publicación a la vez. Un hilo de verdad necesita una apertura que gane el primer toque, un tramo intermedio donde cada publicación aguante sola por un segundo, y un cierre que no simplemente se apague. text.social_thread reestructura en lugar de cortar.
De un artículo completo a una secuencia numerada
Haga POST a /text/social-thread con su artículo o texto largo, reciba un task_id de inmediato, y el hilo llega por webhook firmado o mediante un enlace firmado válido por 24 horas cuando el procesamiento termine. El resultado es una secuencia numerada de publicaciones ajustadas a los límites de cada plataforma, organizada alrededor de los giros reales del argumento y no de los saltos de párrafo del documento original, así que el ritmo del hilo no se limita a copiar el ritmo del texto de origen.
El hilo como formato propio
El formato de hilo nació de una restricción real —una sola publicación era demasiado corta para sostener un argumento completo— y convirtió esa restricción en una estructura con convenciones propias: una primera línea fuerte, una idea por publicación, y un cierre que resuelve en vez de simplemente detenerse. Esas convenciones existen porque cualquier lector puede abandonar después de cualquier publicación, así que un hilo que descarga todo su valor en la primera línea y luego se relaja pierde a la mayoría de sus lectores antes de llegar al remate.
Su lugar en un flujo de contenido
Escritores y equipos de contenido suelen ejecutar este paso justo después de publicar un artículo largo o un boletín, reaprovechando el mismo reporteo o argumento en un segundo formato en lugar de escribir el hilo desde cero. También sirve para convertir la transcripción de una charla, un informe de investigación extenso o un memo interno en algo pensado para leerse en un feed y no en un visor de documentos. Con precio por solicitud más por hilo, el costo es predecible por cada pieza reaprovechada, y una tarea fallida nunca se cobra.
Qué puede hacer con ella
Reaprovechar un boletín en un hilo
Un escritor convierte el boletín largo de cada semana en un hilo complementario para llegar a lectores que recorren un feed en vez de abrir el correo.
Alargar la vida de un informe de investigación
Un equipo de investigación convierte un informe detallado en un hilo que lleva los hallazgos clave a una audiencia que no leerá el documento completo.
Convertir una charla de conferencia en contenido social
Un ponente convierte la transcripción de su charla en un hilo que resume el argumento para quienes se perdieron la sesión.
Anunciar un lanzamiento a fondo en piezas digeribles
Un equipo de producto convierte un informe de lanzamiento detallado en un hilo que recorre el cambio publicación por publicación en vez de un solo párrafo denso.
Preguntas frecuentes
¿Cómo convierto un artículo en un hilo con la API?
Envíe el texto del artículo por POST a /text/social-thread, guarde el task_id devuelto y reciba el hilo numerado por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para generar hilos?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.0135 por hilo, y una tarea fallida nunca se cobra.
¿En qué se diferencia de simplemente cortar el texto cada cierto número de caracteres?
El resultado se reestructura alrededor de los giros del argumento, de modo que cada publicación se sostiene por sí sola, en lugar de cortarse mecánicamente cada cierto número de caracteres.
¿Qué tan largo puede ser el artículo de origen?
Artículos extensos, informes y transcripciones son la entrada esperada; consulte la referencia del endpoint para el largo máximo vigente.
¿Puedo controlar cuántas publicaciones tiene el hilo?
La extensión sigue la estructura natural del material de origen; entradas muy cortas producen hilos cortos y textos largos producen secuencias más extensas.
¿Puedo generar hilos para un backlog de artículos anteriores?
Sí, cada artículo es su propia solicitud asíncrona, así que un backlog es simplemente un lote de solicitudes enviadas juntas.
¿Ya está disponible este endpoint?
Sí, está activo y aceptando solicitudes desde ya.
¿Se conserva el texto de mi artículo después de generar el hilo?
No, el texto enviado y los hilos generados se eliminan después del período de retención y nunca se usan para entrenamiento.
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/social-thread \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/social-thread", {
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/social-thread",
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/social-thread", 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/social-thread", 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.social_thread",
"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. |