Créer une clé API

Les requêtes API sont authentifiées avec une clé API GetRouter. Créez une clé distincte pour chaque application ou outil afin de pouvoir suivre l’utilisation et révoquer les accès indépendamment.

Créer une clé

  1. Connectez-vous à GetRouter.
  2. Ouvrez la page Clés API.
  3. Sélectionnez Create API Key.
  4. Saisissez un nom qui identifie l’application, par exemple Codex, OpenClaw ou Development.
  5. Définissez éventuellement une date d’expiration, une limite d’utilisation ou des restrictions de modèles.
  6. Créez la clé et copiez-la dans un emplacement sécurisé.

Exemple de convention de nommage :

Development
Production API
Codex Laptop
OpenClaw Agent

Authentifier une requête

Envoyez la clé sous forme de jeton Bearer :

curl https://getrouter.ai/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

N’ajoutez pas de guillemets autour de la valeur réelle de la clé dans le champ de clé API d’un outil, sauf si celui-ci l’exige explicitement.

Stocker les clés en toute sécurité

Pour le développement local, placez la clé dans une variable d’environnement :

export GETROUTER_API_KEY="YOUR_API_KEY"

Référencez ensuite la variable depuis votre application :

import os

api_key = os.environ["GETROUTER_API_KEY"]
Danger

Ne validez jamais de clés API dans Git, ne les exposez pas dans du code exécuté côté navigateur et ne les collez pas dans des rapports de problèmes publics. Si une clé est exposée, supprimez-la immédiatement et créez-en une nouvelle.

Utiliser des clés distinctes

Des clés distinctes permettent plus facilement de :

  • Révoquer l’accès d’un outil sans interrompre les autres applications
  • Définir des limites d’utilisation différentes
  • Restreindre une clé aux modèles dont elle a besoin
  • Identifier une utilisation inattendue

Étapes suivantes