# Clés API

Pour [utiliser notre API](/docs/api), vous devez [générer une clé API](/keys/api).

Une fois votre clé obtenue, vous pouvez l'utiliser pour authentifier vos requêtes auprès de notre API.

Avec [`curl`](https://curl.se), vous pouvez par exemple utiliser votre clé API de la façon suivante :

```bash
export AISH_API_KEY="sk_..."

curl -X 'GET' 'https://api.aish.li/v1/ai/agents?limit=3' \
  -H "X-API-Key: $AISH_API_KEY" \
  | jq .
```

Une commande similaire s'affiche également après avoir cliqué sur _Try it out_ et _Execute_ dans la [Référence API](/docs/api).

Notez que cet en-tête `X-API-Key` est différent de l'en-tête `Authorization: Bearer ...`, qui est utilisé uniquement pour l'authentification par jeton OAuth2 dans la documentation interactive de l'API. L'en-tête `X-API-Key` est utilisé à la place d'OAuth2 pour l'authentification par clé API depuis vos propres systèmes backend.

> [!CAUTION]
> Vos clés API sont sensibles et accordent un accès complet à votre compte sans nécessiter votre mot de passe de connexion — y compris à vos agents, à votre historique de sessions et à vos paramètres.
>
> - Ne partagez jamais votre clé API publiquement et ne la validez jamais dans des dépôts Git.
> - N'intégrez jamais de clés API dans du code HTML ou JavaScript côté client.
> - Si vous pensez qu'une clé a été compromise, révoquez-la immédiatement à l'aide de l'icône de corbeille sur la page [Clés API](/keys/api).

Les clés API ne sont affichées qu'une seule fois lors de leur création. Vous devrez en générer une nouvelle si vous la perdez.