Documentación de la API
Todas las implementaciones de FutturaOLLM exponen un endpoint compatible con los clientes de OpenAI. La clave define el tenant, el ambiente y —si la generaste asociada— la implementación.
Endpoint
/api/public/v1/chat/completions
Autenticación
Bearer API key
Conocimiento
RAG automático del tenant
1. Generá una API key
En la consola del tenant, pestaña API Keys, elegí ambiente (demo o producción) y opcionalmente la implementación. La clave completa se muestra una sola vez; en la base sólo queda su hash.
2. Primera llamada
curl https://futtura.lovable.app/api/public/v1/chat/completions \
-H "Authorization: Bearer $FUTTURA_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "mi-implementacion",
"messages": [{"role":"user","content":"¿Cuál es el horario de atención?"}]
}'model es opcional: si la clave está atada a una implementación, se usa ésa; si no, se resuelve por el nombre de la implementación del tenant.
3. Respuesta
{
"id": "futtura-…",
"object": "chat.completion",
"model": "mi-implementacion",
"choices": [
{ "index": 0, "message": { "role": "assistant", "content": "…" }, "finish_reason": "stop" }
],
"usage": { "prompt_tokens": 812, "completion_tokens": 96, "total_tokens": 908 },
"futtura": { "deployment_id": "…", "base_model": "Llama 3.1 70B", "sources": 4 }
}4. SDKs existentes
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.FUTTURA_API_KEY,
baseURL: "https://futtura.lovable.app/api/public/v1",
});
const r = await client.chat.completions.create({
model: "mi-implementacion",
messages: [{ role: "user", content: "Hola" }],
});5. Progreso de entrenamientos y despliegues
Consultá con tu API key el estado de la cola, el progreso, los tiempos estimados y los logs resumidos de cada implementación.
curl "https://futtura.lovable.app/api/public/v1/jobs?limit=10" \ -H "Authorization: Bearer $FUTTURA_API_KEY" # Filtrar por implementación o estado curl "https://futtura.lovable.app/api/public/v1/jobs?deployment_id=<uuid>&status=ejecutando" \ -H "Authorization: Bearer $FUTTURA_API_KEY"
6. Errores
| HTTP | Código | Cuándo ocurre |
|---|---|---|
| 401 | missing_api_key / invalid_api_key / revoked_api_key | Clave ausente, inexistente o revocada. |
| 400 | invalid_request | Cuerpo mal formado o sin mensajes de usuario. |
| 404 | deployment_not_found | La clave no apunta a ninguna implementación del tenant. |
| 409 | deployment_paused | La implementación está pausada por el tenant o por Futtura. |
| 502 | upstream_error | Error del modelo o del gateway; queda registrado en Observabilidad. |
Cada llamada queda trazada
Tokens, latencia, chunks usados y costo se registran por tenant en Observabilidad y Facturación.