API de Vulgate — visión general

Una vista panorámica de las APIs de Ingest, Search y Chat y dónde encontrar cada una.

21 may 2026

La plataforma Vulgate expone todo lo que hace la aplicación web a través de una API REST + JSON. Ya sea que estés construyendo una herramienta interna, un pipeline de investigación o un producto orientado al cliente, la API es tu punto de entrada para ingesta, búsqueda y chat con IA.

Las tres APIs

APIQué haceReferencia
IngestSubir archivos, iniciar trabajos de ingesta, monitorear progreso, gestionar documentos./developers/ingest/overview
SearchEjecutar búsquedas neuronales o por palabras clave en tu Biblioteca. Devolver pasajes o IDs de documentos./developers/search/overview
ChatEndpoint de Chat Completions compatible con OpenAI fundamentado en tu Biblioteca./developers/chat/overview

La API de Chat usa la misma estructura de OpenAI Chat Completions, por lo que la mayoría de los SDKs existentes (Python openai, Vercel ai, LangChain, etc.) funcionan simplemente apuntándolos a https://vulgate.ai/api con tu clave API de Vulgate.

URL base

https://vulgate.ai/api

Todos los endpoints son solo HTTPS.

Autenticación

Cada solicitud necesita un token Bearer en el header Authorization:

Authorization: Bearer <tu-clave-api>

Consulta Crear una clave API para saber cómo generar una.

Ejemplo rápido

Ejecuta una búsqueda en tu Biblioteca:

curl -G "https://vulgate.ai/api/search" \
  -H "Authorization: Bearer $VULGATE_API_KEY" \
  --data-urlencode "search=teología eucarística" \
  --data-urlencode "mode=neural" \
  --data-urlencode "per_page=5"

La respuesta es un objeto JSON con una lista de pasajes de resultados, cada uno con el ID del documento, un índice, el contenido renderizado y los metadatos del documento fuente. Consulta la referencia de la API de Search para conocer todos los campos.

Streaming

La API de Chat admite respuestas en streaming en el formato de OpenAI Chat Completions. Establece stream: true en el cuerpo de la solicitud. Consulta la visión general de la API de Chat.

Límites de tasa

La API de Chat aplica un límite de tasa de ventana deslizante de 10 solicitudes por cada 10 segundos por equipo, con un tiempo de espera de ejecución por solicitud de 120 segundos. La API de Search tiene un tiempo de espera de ejecución por solicitud de 40 segundos. Cuando excedes un límite, la API devuelve HTTP 429.

SDKs

Vulgate actualmente no distribuye un SDK propio, pero la API de Chat es intencionalmente compatible con el cliente de OpenAI. Apunta el SDK de OpenAI a https://vulgate.ai/api y pasa tu clave API de Vulgate:

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.VULGATE_API_KEY,
  baseURL: "https://vulgate.ai/api",
});

Para las APIs de Ingest y Search, cualquier cliente HTTP (fetch, axios, requests) funciona.

Adónde ir a continuación

Buscar ayuda