Documentación

Empieza con la API.

La dirección base para los clientes compatibles es https://api.clodei.esteka.org/v1.

Estado actual: pasarela en preparación para conectar inferencia. La lista de modelos estará vacía mientras no haya un backend configurado. Este entorno todavía no ofrece compromisos de capacidad ni facturación comercial.

1. Acceso

El equipo entra al chat y a operaciones con su cuenta personal. Los programas utilizan una API key individual en la cabecera Authorization: Bearer …. Guarda la clave en una variable de entorno; no la incluyas en código público.

2. Consulta los modelos

curl https://api.clodei.esteka.org/v1/models \
  -H "Authorization: Bearer $CLODEI_API_KEY"

Utiliza uno de los identificadores devueltos en data[].id. Una lista vacía significa que no hay modelos configurados.

3. Envía una conversación

curl https://api.clodei.esteka.org/v1/chat/completions \
  -H "Authorization: Bearer $CLODEI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "ID_DEVUELTO_POR_MODELS",
    "messages": [{"role": "user", "content": "Kaixo!"}],
    "max_tokens": 128,
    "stream": true
  }'

Con stream: true, la respuesta llega como eventos SSE. Con stream: false, recibes un objeto JSON al terminar.

Rutas de la API

Ruta	Uso
GET /v1/models	Catálogo accesible con tu clave
POST /v1/chat/completions	Conversaciones y generación de texto
POST /v1/embeddings	Disponible cuando se configure un modelo de embeddings
GET /healthz	Estado de la pasarela; no certifica la salud de un modelo

Errores y límites

Una clave ausente o inválida se rechaza. Un modelo no configurado también se rechaza. Los límites de uso se aplican por clave; una respuesta 429 indica que debes reducir el ritmo. Consulta el mensaje de error JSON para conocer la causa concreta.

Datos y acceso

El chat conserva las conversaciones en el VPS para que cada usuario pueda recuperarlas y borrarlas. La API está configurada para no guardar el contenido de prompts y respuestas en los registros de la pasarela. Las claves y los datos operativos se respaldan cifrados. El operador del servidor mantiene acceso técnico a sus datos.

El registro público está cerrado. La creación, revocación y recuperación de cuentas se gestiona con el operador de CLODEI.