Chatear con un PDF
Un contrato, manual o informe de 200 páginas es más fácil de interrogar que de leer de principio a fin. Este endpoint convierte un PDF en algo a lo que se le puede preguntar directamente y recibir una respuesta anclada en ese archivo exacto, con el pasaje de donde salió incluido.
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.
Leer no siempre es el objetivo, encontrar sí
Nadie abre un manual de equipo de 90 páginas porque disfrute leerlo; lo abre porque la máquina está haciendo un ruido raro y la página 47 tiene la respuesta. rag.chat_pdf está pensado para ese momento: apúntelo al documento, haga la pregunta real y sáltese por completo el índice. Funciona tan bien con un solo contrato como con una especificación técnica extensa; el documento marca los límites de lo que va a poder responder.
La solicitud y lo que usted recibe
Envíe POST a /rag/chat-pdf con el PDF y una pregunta, y la tarea corre de forma asíncrona: un task_id llega de inmediato, y la respuesta sigue después mediante una llamada de webhook firmada o un enlace firmado que permanece activo por 24 horas. La respuesta viene acompañada del pasaje del PDF de donde se extrajo, para que quien la lea pueda ir directo a la página relevante en vez de creer la respuesta por fe.
El PDF nunca fue pensado para buscarse así
El formato se diseñó a principios de los años noventa para que un documento se viera idéntico en cualquier impresora o pantalla: un diseño fijo y portable, no una fuente de texto estructurada y consultable. Por eso la búsqueda de texto libre dentro de un PDF largo suele decepcionar: encuentra palabras literales, no significado, y se pierde un pasaje que responde su pregunta con otras palabras. La búsqueda por recuperación evita ese problema porque entiende qué está preguntando realmente, no solo qué palabras aparecen en la página.
Dónde encaja dentro de un flujo de documentos
Los equipos que reciben las mismas preguntas una y otra vez sobre el mismo documento, una política, un manual, un acuerdo firmado, dejan de releerlo desde cero cada vez y en su lugar le preguntan directamente. Como el precio es una tarifa fija por solicitud más una tarifa por consulta y la tarea corre de forma asíncrona, una mesa de soporte puede conectar esto detrás de un widget de chat sin temer que un pico de preguntas se traduzca en una factura impredecible o en una interfaz bloqueada mientras se genera la respuesta.
Dónde están los límites
La respuesta solo refleja lo que realmente está escrito en el PDF que usted envía; no va a inventar una cláusula que no existe ni va a responder sobre un documento distinto que no incluyó. Esa restricción es deliberada: una respuesta limitada al material de origen es una en la que se puede confiar lo suficiente para actuar, que es justamente el sentido de preguntarle a un documento en lugar de adivinar.
Qué puede hacer con ella
Consultas al manual del empleado
Un equipo de recursos humanos deja que el personal le pregunte directamente al manual del empleado, por ejemplo cuántos días de licencia parental le corresponden, en vez de buscar manualmente en un PDF largo.
Diagnóstico de manuales técnicos
Un técnico de campo le pregunta al manual del equipo qué significa un código de error y recibe el procedimiento exacto de la página correspondiente.
Búsqueda de cláusulas contractuales
Un equipo de compras le pregunta a un contrato firmado con un proveedor si existe una cláusula de responsabilidad específica, sin releer todo el documento.
Preguntas y respuestas sobre artículos de investigación
Un estudiante le pide a un artículo de investigación extenso que explique su metodología en términos sencillos, citando la sección exacta de donde proviene.
Preguntas frecuentes
¿Cómo chateo con un PDF usando la API?
Envíe por POST el archivo PDF y su pregunta a /rag/chat-pdf, y reciba la respuesta con cita por webhook o mediante un enlace firmado válido por 24 horas.
¿Es gratis la API para chatear con un PDF?
No, no hay plan gratuito ni prueba; cuesta $0.003 por solicitud más $0.015 por consulta, y una tarea fallida nunca se cobra.
¿Funciona con PDF escaneados o solo con PDF de texto?
Funciona con PDF cuyo contenido de texto se pueda extraer; un PDF escaneado que sea solo imagen debería procesarse primero con OCR para obtener respuestas confiables.
¿Puedo hacer varias preguntas sobre el mismo PDF?
Sí, envíe una solicitud separada por cada pregunta; cada una corre de forma independiente y devuelve su propia respuesta con cita.
¿Qué tan precisas son las respuestas?
Las respuestas se anclan en los pasajes recuperados de su PDF y se citan junto a ellos, así que usted puede verificar cualquier afirmación directamente contra la página de origen.
¿Puedo chatear con PDF muy extensos?
Sí, el endpoint recupera los pasajes relevantes dentro del documento sin importar su longitud total antes de generar la respuesta.
¿Ya está disponible este endpoint?
Sí, /rag/chat-pdf está en vivo y listo para tráfico de producción.
¿Se guarda mi PDF después de obtener una respuesta?
No, los PDF cargados y los resultados 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/rag/chat-pdf \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"input":"…"}'const res = await fetch("https://api.kit.forhosting.com/rag/chat-pdf", {
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/rag/chat-pdf",
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/rag/chat-pdf", 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/rag/chat-pdf", 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": "rag.chat_pdf",
"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_chunks | 10000 |
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. |