Escribir un artículo
Le da a la API para generar artículos un título y un brief breve —ángulo, público, puntos clave a cubrir— y devuelve un borrador completo, no un esquema que todavía hay que desarrollar. Existe para el calendario editorial que tiene más espacios que redactores, funcionando como una tarea encolada que permite pedir toda una semana de borradores antes del almuerzo.
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.
La distancia entre un esquema y un borrador
Muchas herramientas de contenido devuelven viñetas y las llaman primer borrador; un gestor de contenido igual tiene que convertir esas viñetas en párrafos legibles antes de que un editor pueda tocarlas. Este endpoint se salta ese paso intermedio: entra el brief, sale un artículo estructurado con introducción, secciones de desarrollo y cierre, de modo que el trabajo del editor empieza en la revisión y no en redactar desde una página en blanco.
Cómo avanza una solicitud por el sistema
Una llamada a POST /text/blog-post con el título y el brief devuelve un task_id de inmediato y encola el trabajo de redacción. El artículo terminado llega después por webhook firmado —la ruta recomendada para una integración con un CMS— o mediante un enlace firmado válido por 24 horas, útil cuando alguien quiere revisar el borrador directamente antes de que entre al flujo de publicación.
Cómo es un buen brief
La calidad del borrador sigue la especificidad del brief de la misma manera que ocurriría con un redactor freelance: un título solo produce un artículo genérico, mientras que un título más público objetivo, tono, puntos clave a cubrir y cosas a evitar produce algo mucho más cercano a lo que un editor realmente quiere en el primer intento. No es una limitación exclusiva del endpoint: así ha funcionado siempre el proceso de dar instrucciones, automatizado o no.
Dónde encaja la generación de artículos en una operación de contenido
Como cada solicitud devuelve un task_id y un webhook, esto se integra directamente en un flujo editorial: una herramienta de calendario de contenido encola el viernes por la tarde los cinco artículos programados para el lunes, recibe cada webhook a medida que termina el borrador, y lo enruta automáticamente a una cola de revisión. Nada en el diseño asume que hay una persona actualizando una pestaña del navegador esperando a que aparezca el artículo.
Expectativas honestas sobre extensión y costo
Los artículos más largos solicitados tardan proporcionalmente más en la cola y cuestan proporcionalmente más, ya que el precio es $0.003 por solicitud más $0.0135 por artículo en lugar de una tarifa plana sin límite de extensión. No hay plan gratuito: el acceso requiere saldo prepago, y una tarea que falla tras tres reintentos nunca se cobra, de modo que una cola llena de solicitudes de borrador nunca se convierte en un cargo sorpresa por un trabajo que nunca llegó a completarse.
Qué puede hacer con ella
Llenar el calendario editorial semanal
Un equipo de contenido encola los briefs de todos los artículos programados el viernes y revisa los borradores terminados desde el feed de webhooks el lunes por la mañana.
Contenido SEO en volumen
Un equipo de crecimiento genera primeros borradores para una larga lista de palabras clave objetivo, y deja que los editores enfoquen su tiempo en verificar datos y pulir en vez de escribir desde cero.
Operaciones de contenido multi-marca
Una agencia que administra varios blogs de clientes encola briefs según la voz de cada marca y enruta automáticamente cada artículo terminado a la cola de revisión del cliente correspondiente.
Artículos de respuesta rápida a temas de coyuntura
Un sitio cercano a una sala de redacción redacta un primer acercamiento a un tema de actualidad en el momento en que un editor envía el brief, reduciendo el tiempo entre la asignación y un texto listo para revisar.
Preguntas frecuentes
¿Cómo funciona la API para generar artículos de blog?
Envía un título y un brief a POST /text/blog-post; la tarea se encola y el borrador terminado se entrega por webhook firmado o por un enlace firmado válido por 24 horas.
¿Es gratuita esta API generadora de artículos?
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.
¿Cómo se cobra cada artículo?
$0.003 por solicitud más $0.0135 por artículo, cobrado únicamente por los artículos efectivamente generados.
¿Qué debería incluir un buen brief?
Un título, el público objetivo, el tono y los puntos clave que debe cubrir el artículo producen un primer borrador notablemente mejor que un título solo.
¿Puedo generar una semana completa de artículos en lote?
Sí: encola una solicitud por artículo; cada una obtiene su propio task_id, así que un lote de borradores puede solicitarse y entregarse en paralelo.
¿Qué pasa si falla la generación del borrador?
La tarea se reintenta automáticamente hasta tres veces, y una tarea que finalmente falla nunca se cobra.
¿Igual tengo que editar el borrador antes de publicar?
Sí: esto devuelve un primer borrador genuino pensado para revisión editorial, no una pieza final lista para copiar y pegar, tal como se trataría cualquier primer borrador escrito por una persona.
¿Por cuánto tiempo está disponible el artículo terminado?
El enlace firmado permanece válido durante 24 horas; después, el borrador se elimina y nunca se usa 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/blog-post \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/blog-post", {
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/blog-post",
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/blog-post", 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/blog-post", 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.blog_post",
"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. |