Guides Imọlẹ Parcours46 / 93
API et intégrations

Configurer l’API Imọlẹ avec vos outils

Créez une clé, enregistrez-la sur votre ordinateur, vérifiez la connexion et connectez vos éditeurs ou agents sans exposer vos secrets.

Étape 1

Créer votre clé Imọlẹ

1

Ouvrir la page API

Connectez-vous à Imọlẹ puis ouvrez API dans le menu principal.

2

Donner un nom à la clé

Choisissez un nom simple comme « Ordinateur personnel », « Site en production » ou « Codex ».

3

Copier la clé immédiatement

La clé complète est affichée une seule fois. Gardez cette page ouverte jusqu’à l’étape suivante.

Ouvrir la page API
Étape 2

Enregistrer la clé sur votre ordinateur

Choisissez votre système. La commande crée une variable nommée IMOLE_API_KEY qui restera disponible après le redémarrage de l’ordinateur.

Ouvrez PowerShell depuis le menu Démarrer.

Windows
[Environment]::SetEnvironmentVariable(
  "IMOLE_API_KEY",
  "collez_votre_cle_ici",
  "User"
)

Remplacez collez_votre_cle_ici par la clé copiée depuis Imọlẹ, puis exécutez la commande une seule fois.

Fermez puis rouvrez complètement le terminal et l’éditeur après cette étape. Les applications déjà ouvertes ne voient pas toujours la nouvelle variable.

Étape 3

Vérifier que la clé fonctionne

Exécutez cette commande dans un nouveau terminal. Une liste de modèles signifie que la connexion fonctionne.

Test de connexion
curl.exe https://api.imole.app/v1/models `
  -H "Authorization: Bearer $env:IMOLE_API_KEY"

Si vous obtenez une erreur 401, la clé est absente, mal copiée ou révoquée. Créez-en une nouvelle et recommencez l’étape 2.

Dans un projet

Utiliser un fichier .env.local sans publier la clé

Certains projets chargent leurs variables depuis un fichier local. Créez .env.local à la racine du projet, puis ajoutez-le à .gitignore pour qu’il ne soit jamais envoyé sur GitHub.

.env.local
IMOLE_API_KEY=collez_votre_cle_ici
IMOLE_BASE_URL=https://api.imole.app/v1
.gitignore
.env
.env.local
.env.*.local

N’utilisez jamais VITE_, NEXT_PUBLIC_ ou PUBLIC_ devant le nom de la clé. Ces préfixes peuvent envoyer la clé dans le navigateur.

Guides par outil

Connecter Imọlẹ à votre éditeur ou votre agent

Codex

Installez Codex, enregistrez votre clé Imọlẹ une seule fois et utilisez la même configuration dans le terminal ou l’extension pour éditeur.

VS Code

Connectez Imọlẹ avec une extension qui accepte un fournisseur compatible OpenAI. Cline offre la configuration visuelle la plus simple ; Continue permet une configuration par fichier.

Zed

Ajoutez Imọlẹ comme fournisseur compatible OpenAI dans Zed, puis gardez la clé dans le trousseau du système plutôt que dans settings.json.

JetBrains

Utilisez le plugin Continue dans IntelliJ IDEA, WebStorm, PyCharm ou un autre éditeur JetBrains compatible.

Cursor

Connectez Imọlẹ dans Cursor avec une extension compatible comme Continue, tout en gardant votre clé en dehors du projet.

Windsurf

Utilisez une extension Open VSX qui accepte un endpoint compatible OpenAI, puis enregistrez la clé Imọlẹ dans cette extension.

Neovim

Configurez Avante.nvim avec un fournisseur Imọlẹ compatible OpenAI et lisez la clé depuis IMOLE_API_KEY.

Emacs

Ajoutez Imọlẹ à gptel comme backend compatible OpenAI et gardez la clé dans la variable d’environnement IMOLE_API_KEY.

Hermes Agent

Installez Hermes Agent, choisissez une seule fois un endpoint personnalisé compatible OpenAI et laissez Hermes conserver la configuration pour les prochaines sessions.

OpenClaw

Installez OpenClaw, déclarez Imọlẹ comme fournisseur personnalisé compatible OpenAI et choisissez le modèle Imọlẹ par défaut.

Autres éditeurs

La plupart des outils compatibles OpenAI demandent seulement une URL de base, une clé API et un identifiant de modèle.