Lessen API Documentation

Lessen es un middleware de inteligencia artificial que te permite acceder a múltiples modelos de IA a través de una sola API. Compatible con el formato de OpenAI, puedes integrar Lessen en tus proyectos con cambios mínimos.

Quick Start

Empieza a usar la API de Lessen en 3 pasos:

1. Obtén tu API Key

Regístrate en app.lessen.es y genera una API key desde el portal de cliente. Las keys tienen el prefijo lsn_sk_.

2. Haz tu primera petición

curl https://api.lessen.es/v1/chat/completions \
  -H "Authorization: Bearer lsn_sk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lessen/lite",
    "messages": [
      {"role": "user", "content": "Hola, ¿cómo funciona Lessen?"}
    ]
  }'

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lessen.es/v1",
    api_key="lsn_sk_tu_api_key"
)

response = client.chat.completions.create(
    model="lessen/lite",
    messages=[
        {"role": "user", "content": "Hola, ¿cómo funciona Lessen?"}
    ]
)

print(response.choices[0].message.content)

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://api.lessen.es/v1',
    apiKey: 'lsn_sk_tu_api_key'
});

const response = await client.chat.completions.create({
    model: 'lessen/lite',
    messages: [
        { role: 'user', content: 'Hola, ¿cómo funciona Lessen?' }
    ]
});

console.log(response.choices[0].message.content);

3. Recibe la respuesta

{
  "id": "chatcmpl-abc123def456",
  "object": "chat.completion",
  "created": 1708000000,
  "model": "gemma3:latest",
  "choices": [{
    "index": 0,
    "message": {
      "role": "assistant",
      "content": "¡Hola! Lessen es un middleware de IA que..."
    },
    "finish_reason": "stop"
  }],
  "usage": {
    "prompt_tokens": 15,
    "completion_tokens": 42,
    "total_tokens": 57
  }
}

Autenticación

Todas las peticiones a la API requieren autenticación mediante un Bearer token en la cabecera Authorization.

Authorization: Bearer lsn_sk_tu_api_key

Scopes de API Key

Cada API key tiene un scope que determina los permisos:

Base URL

Todas las peticiones deben dirigirse a:

https://api.lessen.es

Los endpoints de la API siguen el formato /v1/..., por ejemplo: https://api.lessen.es/v1/models.

Health Check

curl https://api.lessen.es/health

{
  "status": "ok",
  "version": "1.0.0",
  "ollama": "connected",
  "timestamp": "2026-02-14T22:00:00.000Z"
}

Listar Modelos

curl https://api.lessen.es/v1/models \
  -H "Authorization: Bearer lsn_sk_tu_api_key"

{
  "object": "list",
  "data": [
    { "id": "lessen/lite", "owned_by": "lessen", "backend": "ollama" },
    { "id": "lessen/go", "owned_by": "lessen", "backend": "huggingface" },
    { "id": "lessen/pro", "owned_by": "lessen", "backend": "gemini" },
    { "id": "gemma3:latest", "owned_by": "ollama" },
    { "id": "Qwen/Qwen3-235B-A22B", "owned_by": "huggingface" },
    { "id": "gemini-2.5-flash", "owned_by": "google" }
  ]
}

Routing por Tipo de Tarea

El clasificador detecta 4 tipos de tarea y selecciona el modelo óptimo de cada backend:

Headers de transparencia

Cada request a un modelo lessen/* incluye headers para total visibilidad:

Chat Completions

Parámetros del Body

Formato de Mensajes

curl https://api.lessen.es/v1/chat/completions \
  -H "Authorization: Bearer lsn_sk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "lessen/go",
    "messages": [
      {"role": "system", "content": "Eres un experto en programación."},
      {"role": "user", "content": "¿Cómo hago una petición HTTP en Python?"}
    ],
    "temperature": 0.7,
    "max_tokens": 500
  }'

response = client.chat.completions.create(
    model="lessen/go",
    messages=[
        {"role": "system", "content": "Eres un experto en programación."},
        {"role": "user", "content": "¿Cómo hago una petición HTTP en Python?"}
    ],
    temperature=0.7,
    max_tokens=500
)

const response = await client.chat.completions.create({
    model: 'lessen/go',
    messages: [
        { role: 'system', content: 'Eres un experto en programación.' },
        { role: 'user', content: '¿Cómo hago una petición HTTP en Python?' }
    ],
    temperature: 0.7,
    max_tokens: 500
});

Streaming

Para recibir respuestas en tiempo real, activa stream: true. La respuesta se envía como Server-Sent Events (SSE), donde cada chunk contiene un delta del contenido.

stream = client.chat.completions.create(
    model="lessen/lite",
    messages=[{"role": "user", "content": "Cuéntame un chiste"}],
    stream=True
)

for chunk in stream:
    content = chunk.choices[0].delta.content
    if content:
        print(content, end="", flush=True)

const res = await fetch('https://api.lessen.es/v1/chat/completions', {
    method: 'POST',
    headers: {
        'Authorization': 'Bearer lsn_sk_tu_api_key',
        'Content-Type': 'application/json'
    },
    body: JSON.stringify({
        model: 'lessen/lite',
        messages: [{ role: 'user', content: 'Hola' }],
        stream: true
    })
});

const reader = res.body.getReader();
const decoder = new TextDecoder();

while (true) {
    const { done, value } = await reader.read();
    if (done) break;
    const text = decoder.decode(value);
    // Parsear cada línea "data: {...}"
    console.log(text);
}

curl -N https://api.lessen.es/v1/chat/completions \
  -H "Authorization: Bearer lsn_sk_tu_api_key" \
  -H "Content-Type: application/json" \
  -d '{"model":"lessen/lite","messages":[{"role":"user","content":"Hola"}],"stream":true}'

Formato SSE

Cada evento SSE tiene el formato data: {json}\n\n. El stream finaliza con data: [DONE].

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"¡"},"index":0}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"Hola"},"index":0}]}

data: {"id":"chatcmpl-abc","object":"chat.completion.chunk","choices":[{"delta":{"content":"!"},"index":0,"finish_reason":"stop"}]}

data: [DONE]

Errores

La API devuelve errores en formato JSON con un campo error que contiene message y type.

{
  "error": {
    "message": "Invalid or revoked API key",
    "type": "authentication_error"
  }
}

Rate Limits

Los límites de peticiones se aplican por API key y se reinician cada 24 horas (UTC).

Cuando superas el límite, recibirás un 429 Too Many Requests con un mensaje indicando cuándo se reinicia.

SDKs & Librerías

Lessen es 100% compatible con el SDK de OpenAI. Solo necesitas cambiar la base URL.

Python

pip install openai

from openai import OpenAI

client = OpenAI(
    base_url="https://api.lessen.es/v1",
    api_key="lsn_sk_tu_api_key"
)

Node.js / JavaScript

npm install openai

import OpenAI from 'openai';

const client = new OpenAI({
    baseURL: 'https://api.lessen.es/v1',
    apiKey: 'lsn_sk_tu_api_key'
});

cURL / HTTP directo

Si prefieres no usar un SDK, puedes hacer peticiones HTTP directas a la API. Cualquier cliente HTTP funciona.

Precios

Elige el plan que mejor se adapte a tu proyecto. Todos los planes incluyen acceso a la API.

Soporte

¿Necesitas ayuda? Estamos aquí para ti.

• Email: dev@lessen.es
• Portal de cliente: app.lessen.es
• Status: GET /health para verificar el estado del servicio