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

HTTPCódigoCuándo ocurre
401missing_api_key / invalid_api_key / revoked_api_keyClave ausente, inexistente o revocada.
400invalid_requestCuerpo mal formado o sin mensajes de usuario.
404deployment_not_foundLa clave no apunta a ninguna implementación del tenant.
409deployment_pausedLa implementación está pausada por el tenant o por Futtura.
502upstream_errorError 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.