Autenticación

Todas las solicitudes a la API de Lurus requieren autenticación. Se admiten dos modos complementarios; elige uno según el caso de uso:

API Key El inicio más rápido

Bearer Token, ideal para scripts y proyectos personales. Es el tema principal de esta página.

Token OIDC / OAuth2

Basado en el sistema de identidad unificado, ideal para aplicaciones que requieren inicio de sesión de usuario, SSO empresarial y M2M. Consulta Integración OIDC y PAT / JWT.

Métodos de autenticación

Usa un Bearer TokenBearer TokenUn método de autenticación HTTP que transporta la credencial en la cabecera de la solicitud con el formato "Bearer sk-xxx". y envía la API KeyAPI KeyCredencial de acceso a la API, similar a una contraseña. Cada Key puede tener cuotas y permisos configurados de forma independiente.Más información → en el encabezado HTTP:

Authorization: Bearer sk-your-api-key

Ejemplo de solicitud

curl https://hub.lurus.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-your-api-key" \
  -H "Content-Type: application/json" \
  -d '{"model": "deepseek-chat", "messages": [{"role": "user", "content": "Hi"}]}'

Python

from openai import OpenAI

client = OpenAI(
    base_url="https://hub.lurus.cn/v1",
    api_key="sk-your-api-key",  # 建议改为 os.environ.get("LURUS_API_KEY")
)

Node.js

import OpenAI from 'openai';

const client = new OpenAI({
  baseURL: 'https://hub.lurus.cn/v1',
  apiKey: 'sk-your-api-key',  // 建议改为 process.env.LURUS_API_KEY
});

La lista completa de SDK se encuentra en Descripción general de la API — Compatibilidad con SDK.

Variables de entorno

Se recomienda almacenar la API Key en variables de entorno para evitar codificarla directamente en el código:

# .env
LURUS_API_KEY=sk-your-api-key

import os
from openai import OpenAI

client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ.get("LURUS_API_KEY"))

Errores de autenticación

Código de estado	code	type	Causas comunes
401 Unauthorized	invalid_api_key	authentication_error	Formato de Key incorrecto / deshabilitada o eliminada / formato del encabezado Authorization incorrecto
403 Forbidden	access_denied	authorization_error	La Key no tiene permiso para ese modelo / cuenta suspendida / cuota agotada

La estructura JSON de la respuesta de error y la estrategia de reintentos se encuentran en Gestión de errores.

Buenas prácticas de seguridad

Usa variables de entorno

No codifiques la API Key directamente en el código

No la expongas

No la subas a un repositorio Git

Limita los permisos

Concede a la Key solo los permisos mínimos necesarios

Rótala periódicamente

Cambia la API Key de forma periódica

Monitorea los registros

Revisa periódicamente los registros de llamadas a la API

---

Próximos pasos

Chat Completions APIGestión de erroresDescripción general de la APIIntegración OIDC