Authentification

Toutes les requêtes à l’API Lurus nécessitent une authentification. Deux modes complémentaires sont pris en charge ; choisissez-en un selon le contexte :

API Key prise en main la plus rapide

Bearer Token, idéal pour les scripts et les projets personnels. Sujet principal de cette page.

Token OIDC / OAuth2

Basé sur le système d’identité unifié, adapté aux applications nécessitant une connexion utilisateur, au SSO d’entreprise et au M2M. Voir Intégration OIDC et PAT / JWT.

Méthode d’authentification

Utilisez un Bearer TokenBearer TokenMéthode d'authentification HTTP qui transporte l'identifiant dans l'en-tête de requête au format "Bearer sk-xxx"., en transmettant la API KeyAPI KeyIdentifiant secret permettant d'accéder à l'API, semblable à un mot de passe. Chaque Key peut avoir ses propres quotas et permissions.En savoir plus → dans l’en-tête HTTP :

Authorization: Bearer sk-your-api-key

Exemple de requête

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
});

Pour la liste complète des SDK, voir Aperçu de l’API — Prise en charge des SDK.

Variables d’environnement

Il est recommandé de stocker la clé API dans une variable d’environnement afin d’éviter le codage en dur :

# .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"))

Erreurs d’authentification

Code de statut	code	type	Causes fréquentes
401 Unauthorized	invalid_api_key	authentication_error	Format de clé incorrect / clé désactivée ou supprimée / format de l’en-tête Authorization incorrect
403 Forbidden	access_denied	authorization_error	La clé n’a pas l’autorisation pour ce modèle / compte suspendu / quota épuisé

Pour la structure JSON des réponses d’erreur et la stratégie de relance, voir Gestion des erreurs.

Bonnes pratiques de sécurité

Utiliser des variables d’environnement

Ne pas coder en dur la clé API dans le code

Ne pas divulguer

Ne pas valider dans un dépôt Git

Restreindre les autorisations

N’accorder à la clé que les autorisations minimales nécessaires

Rotation régulière

Renouveler périodiquement la clé API

Surveiller les journaux

Vérifier régulièrement les journaux d’appels à l’API

---

Étapes suivantes

API Chat CompletionsGestion des erreursAperçu de l'APIIntégration OIDC