Clé API et authentification
Créez et gérez vos clés API AGTCloud et configurez les Headers d’authentification requis.
La clé API authentifie vos requêtes à l’API AGTCloud. La plupart des API utilisent une clé API Bearer ; les protocoles compatibles tels qu’Anthropic Messages utilisent des Headers d’authentification spécifiques. Consultez la page de l’endpoint pour connaître les exigences exactes.
| Configuration | Valeur |
|---|---|
| Base URL | https://api.agtcloud.cn/v1 |
| La plupart des API | Authorization: Bearer your-api-key |
| Anthropic Messages | x-api-key: your-api-key et anthropic-version: 2023-06-01 |
Créer une clé API
- Ouvrez API Keys.
- Cliquez sur Créer une clé API.
- Copiez votre clé API et conservez-la en lieu sûr.
Protéger la clé API
N’affichez pas la clé API complète dans des captures d’écran, conversations, tickets ou du code public. En cas de fuite présumée, désactivez ou supprimez l’ancienne clé et ajoutez un nouveau jeton.
Utiliser une clé API
Authentification Bearer
Utilisez https://api.agtcloud.cn/v1 comme Base URL et ajoutez ce Header à la requête :
Authorization: Bearer your-api-keyLa Base URL recommandée inclut déjà /v1. Ne l’ajoutez pas une seconde fois à l’URL de requête, car le chemin serait incorrect.
Vérifier la clé API
Demandez la liste des modèles visibles pour la clé API actuelle afin de vérifier la Base URL et l’authentification :
curl 'https://api.agtcloud.cn/v1/models' \
-H 'Authorization: Bearer your-api-key'Anthropic Messages
Pour appeler l’API compatible Anthropic Messages, transmettez la clé API via x-api-key et fournissez le Header obligatoire anthropic-version :
x-api-key: your-api-key
anthropic-version: 2023-06-01Consultez les exigences complètes dans Anthropic Messages.
Gérer les clés API
La page API Keys vous permet de :
- Ajouter des jetons pour différents environnements ou applications.
- Désactiver les jetons inutilisés ou présumés compromis.
- Supprimer les jetons dont vous n’avez plus besoin.
Configuration des outils tiers
Pour configurer un outil tiers utilisant le protocole compatible OpenAI, fournissez généralement les informations suivantes :
| Paramètre de configuration | Valeur à saisir |
|---|---|
| API Host / Base URL | https://api.agtcloud.cn/v1 |
| API Key | Clé API créée par le compte actuel |
| Modèle | Identifiant d’un modèle disponible pour le site et le compte actuels |
Vous pouvez obtenir les identifiants de modèles dans le Catalogue de modèles ; consultez les instructions de configuration dans Intégrations tierces.
Gestion de la sécurité
En production, lisez la clé API depuis une variable d’environnement côté serveur ou un service de gestion de secrets :
export AGTCLOUD_API_KEY='your-api-key'- N’inscrivez pas la clé API dans le code source et ne la déposez pas dans le système de gestion de versions.
- N’envoyez pas la clé API au navigateur, dans un paquet d’application mobile ou à un autre client non fiable.
- Utilisez des clés API distinctes pour le développement, les tests et la production.
- En cas de fuite présumée, désactivez ou supprimez immédiatement l’ancienne clé et remplacez-la.