Votre premier appel en 5 minutes
Obtenir une clé → Envoyer une requête → Changer de modèle : trois étapes suffisent.
Prérequis
Un compte Lurus (l’inscription offre un quota gratuit ; la première étape vous guide pour le créer) · Python 3.8+ / Node.js 18+ / Go 1.21+ / cURL (au choix) · des notions de base du terminal. Durée estimée : 5 minutes.
Créer un compte —— Démarrer gratuitement
L’inscription offre un quota gratuit : aucun rechargement n’est nécessaire pour suivre ce tutoriel.
Utilisable dès l’inscription, sans frais
Tout nouveau compte reçoit automatiquement 5 鹿贝 + un quota gratuit (offre Free 100 appels/jour, incluant deepseek-chat et gpt-3.5-turbo), largement suffisant pour suivre ce tutoriel. Pour les détails sur les quotas et la mise à niveau, voir la Foire aux questions et les explications de facturation.
Créez ensuite une clé d’API :
Rendez-vous sur hub.lurus.cn, connectez-vous ou inscrivez-vous
Allez dans « Gestion des jetons » → « Créer un nouveau jeton »
Copiez la clé générée (format :
sk-xxxxxxxxxxxxxxxx)
Conseil de sécurité
Une clé d’API équivaut à un mot de passe. Ne la commitez pas dans Git, ne l’écrivez pas dans du code front-end. Il est recommandé de la transmettre via une variable d’environnement :
export LURUS_API_KEY="sk-your-key-here"Envoyer votre première requête
Choisissez votre langage, copiez et exécutez.
Le modèle a répondu ? Votre premier appel est réussi 🎉
Cette requête a utilisé le quota gratuit offert à l’inscription, sans dépenser un centime. Étape suivante : essayez un autre modèle —— le code ne change presque pas.
Changer de modèle
Modifiez uniquement le paramètre model, sans toucher au reste du code. Choisissez un modèle : l’extrait ci-dessous se met à jour instantanément et est prêt à copier-coller.
from openai import OpenAI
import os
client = OpenAI(base_url="https://hub.lurus.cn/v1", api_key=os.environ["LURUS_API_KEY"])
response = client.chat.completions.create(
model="deepseek-chat",
messages=[{"role": "user", "content": "你好"}],
)
print(response.choices[0].message.content)Vous ne savez pas lequel choisir ?
Usage quotidien → deepseek-chat (coût le plus bas, meilleur en chinois)
Raisonnement complexe → deepseek-reasoner
Traitement de longs documents → gemini-3-pro-preview
Comparatif complet dans Modèles pris en charge.
Ça ne marche pas ? Commencez ici
Retourne 401 Unauthorized
{"error": {"code": "invalid_api_key", "type": "authentication_error"}}Vérifiez :
- que la clé commence bien par
sk- - le format de l’en-tête :
Authorization: Bearer sk-xxxx(notez l’espace après Bearer) - que la clé est à l’état « activé » (à confirmer dans la console)
Retourne "no available server"
- Vérifiez l’orthographe du nom du
model(sensible à la casse) - Confirmez que cette clé a le droit d’accéder à ce modèle
- Si la clé vient d’être créée, attendez environ 10 secondes puis réessayez
Comment activer la réponse en streaming ?
Ajoutez "stream": true dans le corps de la requête ; voir réponse en streamingStreamingRéponse en flux : le modèle d'IA renvoie le résultat token par token (au lieu d'attendre la génération complète), ce qui réduit la latence du premier caractère..