Aller au contenu
Documentation 1折AI
Français

Obtenir et gérer les clés API

Créer des clés API commençant par sk- dans la console 1折AI, ainsi que les stocker, les faire tourner et limiter les dégâts en cas de fuite.

Une clé API (API key) correspond à une autorisation d’appel, et débite le solde de votre compte. Cette page explique comment en créer, où les stocker, et quoi faire en cas de problème.

Créer une clé API

Section intitulée « Créer une clé API »

  1. Se connecter à la console

    Ouvrez 1zheai.com/console.

  2. Nouveau

    Dans le menu de gauche, cliquez sur « Clés API », puis sur « Créer une clé API » en haut à droite. Saisissez un nom qui indique l’usage, par exemple claude-code-macbook, ci-staging ; les autres champs peuvent rester inchangés, puis cliquez sur « Enregistrer les modifications ».

    Champs configurables dans le formulaire :

    Champ du formulairePar défautDescription
    NomVideSert à distinguer les clés API dans les journaux d’appels
    Date d’expirationJamaisOptionnel : 1 heure, 1 jour, 1 mois, ou une date et une heure précises
    Quantité1Permet d’en créer plusieurs à la fois ; un suffixe aléatoire est ajouté automatiquement au nom
    Bascule « Quota illimité »ActivéeLorsqu’elle est désactivée, le champ « Quota (USD) » apparaît ; cette clé API ne peut pas dépenser plus que ce montant en dollars
    Restriction de modèles (dans « Paramètres avancés »)Vide, ce qui signifie que tous les modèles sont utilisablesUne fois des modèles sélectionnés, cette clé API ne peut appeler que ces modèles
    Liste blanche d’IP (dans « Paramètres avancés »)Vide, ce qui signifie aucune restrictionN’autorise que les IP ou plages CIDR listées à appeler

  3. Copier et enregistrer

    Les clés API commencent par sk-. Après les avoir copiées, placez-les dans un gestionnaire de mots de passe ou des variables d’environnement ; ne les collez pas dans des conversations, des captures d’écran ou des dépôts de code.

Une clé API par outil

Section intitulée « Une clé API par outil »

Il est recommandé de créer une clé API distincte pour chaque outil et chaque machine. Trois avantages :

  • Les journaux d’appels sont distingués par clé API ; on voit d’un coup d’œil quel outil a dépensé combien.
  • Si une clé API fuite, il suffit de supprimer celle-ci ; les autres outils ne sont pas affectés.
  • Dans une équipe, chacun est responsable de sa clé API ; supprimez la clé correspondante lors d’un départ ou d’un changement de machine.

Où les stocker

Section intitulée « Où les stocker »
Shell 配置（macOS / Linux）
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"

Le fichier .claude/settings.json au niveau projet de Claude Code est généralement commité dans le dépôt, et la documentation officielle de Claude Code déconseille explicitement d’y écrire des identifiants. Placez la clé API dans le fichier ~/.claude/settings.json au niveau utilisateur, ou dans le fichier .claude/settings.local.json du projet qui n’est pas commité.

Que faire en cas de fuite

Section intitulée « Que faire en cas de fuite »
  1. Retrouvez-la dans la liste des « Clés API », cliquez sur l’icône « Désactiver » de la colonne « Actions », ou choisissez « Supprimer » dans le menu «⋯ ». Une fois désactivée, elle prend effet immédiatement ; toute tentative d’appel avec elle renverra 401 Invalid token.
  2. Créez une nouvelle clé API et remplacez l’ancienne là où elle était utilisée.
  3. Ouvrez les journaux d’appels (menu de la console « Journaux d’appels »), cliquez sur « Développer », filtrez en saisissant le nom de cette clé API dans « Nom du jeton », et vérifiez si des appels récents n’ont pas été initiés par vous.

Questions fréquentes

Section intitulée « Questions fréquentes »
Une clé API peut-elle servir à la fois pour Claude Code et Cursor ?

Oui, une clé API n’est pas liée à un outil. Cependant, après un usage mixte, les journaux ne permettent plus de savoir qui a dépensé quoi ; il est donc toujours recommandé d’en créer une par outil.

Message Invalid token / 401, est-ce un problème de clé API ?

Dans la plupart des cas, oui. Causes courantes : espaces ou sauts de ligne lors de la copie, clé API supprimée, saisie dans un champ erroné de l’outil. Pour un diagnostic étape par étape, voirCodes d’erreur et dépannage.

Les clés API expirent-elles ?

Par défaut, jamais. Lors de la création ou de la modification, vous pouvez définir une date dans « Date d’expiration » ; après expiration, tout appel renverra 401 Invalid token, identique à la réponse renvoyée lorsque la clé API est mal saisie. La colonne « Expiration » de la liste affiche la date d’expiration de chaque clé API.