Generar un FAQ
La mayoría de las secciones de preguntas frecuentes se escriben desde cero y a partir de una suposición sobre lo que la gente podría preguntar. La API Generar FAQ lee un contenido que ya tiene —una página de producto, una política, un conjunto de documentos— y extrae las preguntas que ese texto realmente responde, junto con respuestas concisas tomadas del mismo material, para que el FAQ refleje lo que está documentado de verdad y no lo que alguien imaginó.
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 FAQ adivinado y uno fundamentado
Escribir un FAQ desde cero suele significar adivinar las preguntas de los clientes, y esas suposiciones se alejan con el tiempo de lo que un producto o una política dicen en realidad: alguien agrega un nuevo plan de precios y el FAQ anterior queda desactualizado sin que nadie lo note. Este endpoint trabaja en sentido contrario: parte de su texto fuente y saca a la superficie las preguntas que ese texto ya está en condiciones de responder, lo que mantiene el FAQ atado a lo que el documento dice hoy y no a lo que un redactor supuso hace seis meses.
Qué pasa entre la solicitud y el resultado
Envía su contenido fuente por POST a /text/faq. La tarea se procesa de forma asíncrona, y la lista resultante de pares pregunta-respuesta se entrega a su webhook o a un enlace firmado en cuanto está lista. Cada respuesta se fundamenta en el texto enviado en lugar de inventarse, de modo que el resultado se puede contrastar directamente contra la fuente, algo útil cuando el FAQ va a representar una política o los términos de un producto pago.
Por qué el FAQ es un formato con historia propia
El FAQ como tipo de documento es anterior a la web: viene de los grupos de noticias de Usenet en los años ochenta, donde comunidades activas se cansaron de responder las mismas preguntas de principiantes y decidieron escribirlas una sola vez. Ese propósito original sigue vigente: un FAQ existe para responder el puñado de preguntas que se repiten una y otra vez, formuladas como las haría una persona real, no como una empresa preferiría formularlas. Esta tarea está ajustada para extraer ese tipo de redacción natural y frecuente, no una reformulación corporativa de títulos.
Cómo encaja en un flujo de contenido continuo
Al ser asíncrono y cobrarse por llamada, los equipos suelen ejecutarlo cada vez que el contenido fuente cambia: una actualización de documentación dispara una nueva generación de FAQ para la página correspondiente, o un equipo de soporte regenera los FAQ trimestralmente contra el texto vigente de la política. Una generación fallida se reintenta automáticamente hasta tres veces y nunca se cobra, algo relevante cuando esto corre sin supervisión sobre decenas de páginas de forma programada.
Qué esperar del resultado
El resultado es un conjunto de pares pregunta-respuesta que suele cubrir desde la pregunta más obvia que tendría un lector hasta los casos menos evidentes que el texto fuente llega a abordar. No inventará una política que no esté en su texto; si la fuente guarda silencio sobre algo, el FAQ también lo hará, y ese es justamente el punto: el resultado es tan completo como el material que le entregue.
Qué puede hacer con ella
FAQ en páginas de producto
Un equipo de comercio electrónico genera un bloque de FAQ para cada página de producto directamente desde sus especificaciones y política de envío, manteniéndolo sincronizado de forma automática.
Documentación de soporte
Una empresa de software pasa sus artículos del centro de ayuda por el endpoint para construir un FAQ consultable sin releer manualmente cada artículo.
Páginas de políticas y términos
Un equipo legal o de cumplimiento convierte un extenso documento de términos de servicio en un FAQ en lenguaje claro que responde las preguntas reales de los usuarios.
Onboarding y wikis internas
Un equipo de recursos humanos convierte un manual interno en un FAQ que los nuevos empleados pueden consultar en vez de leer el documento completo de principio a fin.
Preguntas frecuentes
¿Cómo genero un FAQ a partir de mi contenido con esta API?
Envíe su texto fuente por POST a /text/faq; la tarea corre de forma asíncrona y los pares de pregunta y respuesta se entregan por webhook o por un enlace firmado.
¿Hay una prueba gratuita para la API de generar preguntas frecuentes?
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ánto cuesta generar un FAQ?
$0.003 por solicitud más $0.0135 por cada 1.000 palabras del contenido fuente, y solo se cobra cuando la tarea se completa con éxito.
¿Inventa respuestas que no están en mi contenido?
No, las respuestas se fundamentan en el texto que envía; si su contenido no cubre un tema, ese tema simplemente no aparecerá como pregunta.
¿Cuántas preguntas genera?
La cantidad escala de forma natural según la extensión y el alcance de su contenido fuente, en lugar de un número fijo, así que un documento más largo suele arrojar más preguntas distintas.
¿Puedo usarla en documentos largos como una página de términos de servicio?
Sí, el precio escala según el número de palabras, así que páginas extensas de políticas o documentación funcionan bien como material fuente.
¿Qué pasa si falla la tarea de generación de FAQ?
Se reintenta automáticamente hasta tres veces y nunca se cobra una tarea que no llega a completarse.
¿Cómo y cuándo recibo el resultado del FAQ?
Mediante un webhook firmado, recomendado para procesos automatizados, o un enlace firmado válido por 24 horas; el contenido fuente se elimina al vencer la retención 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/faq \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"…"}'const res = await fetch("https://api.kit.forhosting.com/text/faq", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "…"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/text/faq",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "…"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/text/faq", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"…"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"…"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/text/faq", 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
{
"text": "…"
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "text.faq",
"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. |