---
title: "Obtenir et gérer les clés API"
description: "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."
headingIds: {"Créer une clé API":"section-1","Une clé API par outil":"section-2","Où les stocker":"section-3","Que faire en cas de fuite":"section-4","Questions fréquentes":"section-5"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentation maintenue par [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Sources et corrections](https://1zheai.com/en/editorial/).

Vous avez trouvé une erreur ? [Contactez l'assistance](mailto:support@1zheai.com) en indiquant l'adresse de la page et une description. N'envoyez pas de clés API ni d'identifiants de compte.

</aside>
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

<Steps>
<Step title="Se connecter à la console">

Ouvrez [1zheai.com/console](https://1zheai.com/console?lng=fr).

</Step>
<Step title="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 formulaire | Par défaut | Description |
|---|---|---|
| Nom | Vide | Sert à distinguer les clés API dans les journaux d'appels |
| Date d'expiration | Jamais | Optionnel : 1 heure, 1 jour, 1 mois, ou une date et une heure précises |
| Quantité | 1 | Permet d'en créer plusieurs à la fois ; un suffixe aléatoire est ajouté automatiquement au nom |
| Bascule « Quota illimité » | Activée | Lorsqu'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 utilisables | Une 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 restriction | N'autorise que les IP ou plages CIDR listées à appeler |

</Step>
<Step title="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.

</Step>
</Steps>

## 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

<CodeGroup>
```bash title="Shell 配置（macOS / Linux）"
# 写进 ~/.zshrc 或 ~/.bashrc，只在本机生效
export ONEZHE_API_KEY="sk-你的Key"
```
```powershell title="Windows（当前用户，持久）"
[Environment]::SetEnvironmentVariable("ONEZHE_API_KEY", "sk-你的Key", "User")
# 重新打开终端后生效
```
```bash title=".env（项目本地）"
# .env 要写进 .gitignore
ONEZHE_API_KEY=sk-你的Key
```
</CodeGroup>

<Warning>

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é.

</Warning>

## 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

<AccordionGroup>
<Accordion title="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.

</Accordion>
<Accordion title="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, voir[Codes d'erreur et dépannage](/fr/docs/troubleshooting/).

</Accordion>

<Accordion title="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.

</Accordion>
</AccordionGroup>