Ventana de Contexto
Preguntar a varios documentos
Endpoint
https://claix.dev/multi-documentEnvía hasta 10 archivos en una sola llamada, junto con las mismas preguntas tipadas que Consultar espacio. Cada archivo se convierte a Markdown y las respuestas se construyen cruzando esos textos. No hay schema_id y los archivos no tienen que estar guardados de antemano.
Los formatos admitidos son los mismos que Extracción → Markdown: PDF, Excel/CSV, Word y texto, HTML/XML, imágenes y audio.
URL pública: POST https://claix.dev/multi-document. Nunca expongas la URL directa de Supabase.
1. Autenticación
La misma comprobación de API key que Consultar documento y Consultar espacio. La key tiene que existir y estar activa, y la cuenta tiene que estar activa.
x-api-key: <TU_API_KEY>
O bien:
Authorization: Bearer <TU_API_KEY>
2. Parámetros
Método: POST · Content-Type: multipart/form-data
| Campo | Obligatorio | Descripción |
|---|---|---|
| file | Sí | Repite el campo de 1 a 10 veces. También se aceptan files y documents. Mismos formatos y límites de tamaño que Extracción → Markdown. |
| questions | Sí | JSON con un array de { question, format }. Máximo 5 preguntas, 400 caracteres cada una. format: string | int | boolean | timestamp | array. |
| window_context | No | true conserva cada documento convertido. Si no viene, o es false, solo se responden las preguntas. |
| window_time | Obligatorio si window_context es true | Minutos: 5, 10, 15, 30, 45, 60, 90, 120, 180, 240, 360, 480, 720, 1440, o infinity. infinity exige el modo persistente activo en la cuenta. |
| space_id | No | Espacio de conocimiento del dueño de la API key. Solo si window_context es true. Los documentos conservados se asocian a ese espacio. |
3. Respuesta
La misma forma que Consultar espacio, más documents_processed. Las respuestas quedan alineadas con las preguntas y usan el format pedido, o null si el dato no está en los archivos. Si la verificación de fuente está activada en la consulta a espacios de conocimiento, cada respuesta es { value, source }.
{
"user_ask": [
{ "question": "¿Qué proveedor factura más en total?", "format": "string" }
],
"ia_response": ["Suministros Omega S.A."],
"documents_processed": 2,
"log_id": "LOG_UUID"
}log_id identifica la llamada en el panel de logs.
4. Códigos de estado
| Código | Cuándo |
|---|---|
| 200 | Preguntas respondidas. |
| 400 | Faltan questions o archivos, hay más de 10 archivos, formato no soportado, window_time inválido, space_id sin window_context, o infinity sin modo persistente. |
| 401 | API key ausente, inválida, inactiva o cuenta no activa. |
| 404 | space_id no existe en esta cuenta. |
| 405 | Método distinto de POST. |
| 413 | Un archivo supera el límite de su formato. |
| 422 | Un archivo no pudo convertirse en Markdown legible. |
| 502 | Falló la llamada al modelo. |