Appeler l’API avec le SDK OpenAI
Branchez une application existante sur l’API Learnya en changeant seulement l’adresse et la clé du client OpenAI.
10 min · 6 passos · para todos
- Passo 1
Créez une clé
Depuis votre compte, avec le plan Dev ou Team, créez une clé d’API. Limitez ses portées au strict nécessaire, fixez un quota et, si votre serveur a une adresse fixe, ajoutez-la à la liste des IP autorisées.
- Passo 2
Installez le SDK
Installez la bibliothèque officielle OpenAI dans votre projet, par exemple avec pip install openai en Python. Stockez la clé dans une variable d’environnement, jamais dans le code.
- Passo 3
Pointez le client vers Learnya
Créez le client avec base_url="https://api.learnya.ai/v1" et votre clé Learnya. Le reste de votre code ne change pas, puisque l’API est compatible OpenAI.
- Passo 4
Faites un premier appel
Appelez client.chat.completions.create(model="flash", messages=[{"role": "user", "content": "Résume ce texte en trois points."}]). Utilisez le modèle "max" pour les tâches qui demandent un raisonnement long.
- Passo 5
Ajoutez embeddings et images
Les mêmes appels du SDK servent pour les embeddings et la génération d’images. Les données restent en Suisse et ne servent jamais à entraîner les modèles.
- Passo 6
Gérez quotas et limites
Prévoyez une nouvelle tentative avec délai quand l’API répond 429, signe que la limite de débit est atteinte. Suivez la consommation de chaque clé depuis votre compte.