> ## Documentation Index > Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt > Use this file to discover all available pages before exploring further. # Récupérer une clé API > Utilisez CometAPI GET /api/token/{id} pour récupérer un enregistrement de clé API par ID pour le compte authentifié. Utilisez ce endpoint pour récupérer un enregistrement de clé API par ID. Générez un personal access token dans [Console → Personal Settings](https://www.cometapi.com/console/personal), puis envoyez-le comme valeur brute de l’en-tête `Authorization`. Ne le préfixez pas avec `Bearer`. Le paramètre de chemin `id` est l’ID numérique de la clé renvoyé par [Lister les clés API](./list-api-keys). ## Statut de la clé API | Status | Meaning | | ------ | ---------- | | `1` | Activée | | `2` | Désactivée | | `3` | Expirée | | `4` | Épuisée | ## Champs renvoyés | Field | Type | Description | | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | integer | ID numérique de la clé API. Utilisez cette valeur avec [Mettre à jour une clé API](./update-api-key) et [Supprimer une clé API](./delete-api-key). | | `key` | string | Valeur de la clé API renvoyée par l’API de gestion. Traitez-la comme un secret et utilisez-la comme `Authorization: Bearer $COMETAPI_KEY` pour les requêtes de modèle. | | `status` | integer | Statut opérationnel. Seule la valeur `1` signifie que la clé est activée pour les requêtes de modèle. | | `name` | string | Nom d’affichage lisible par l’utilisateur pour la clé. | | `created_time` | integer | Horodatage Unix en secondes indiquant quand la clé a été créée. | | `accessed_time` | integer | Horodatage Unix en secondes indiquant quand la clé a été utilisée pour la dernière fois. | | `expired_time` | integer | Horodatage Unix en secondes indiquant quand la clé expire. `-1` signifie aucune expiration. | | `remain_quota` | integer | Quota restant en unités de quota internes de CometAPI. | | `used_quota` | integer | Quota déjà consommé par cette clé en unités de quota internes de CometAPI. | | `unlimited_quota` | boolean | Indique si la clé contourne les vérifications de quota restant. | | `model_limits_enabled` | boolean | Indique si les restrictions de modèle sont actives pour cette clé. | | `model_limits` | string | model ID autorisés par cette clé, séparés par des virgules, lorsque `model_limits_enabled` vaut `true`. Une valeur vide signifie qu’aucune liste de modèles n’est configurée. | | `allow_ips` | string or null | Liste d’autorisation IP sous la forme d’une chaîne unique séparée par des sauts de ligne. Chaque entrée peut être une adresse IPv4 unique, une adresse IPv6 unique, un CIDR IPv4 ou un CIDR IPv6. `null` ou `""` signifie aucune restriction IP. | | `group` | string | Restriction de groupe de compte. Une valeur vide signifie aucune restriction de groupe explicite. | | `cross_group_retry` | boolean | Indique si la nouvelle tentative inter-groupe est activée pour le routage automatique des groupes. | ## OpenAPI ````yaml api/openapi/api-keys/get-api-key.openapi.json GET /api/token/{id} openapi: 3.1.0 info: title: Get API Key version: 1.0.0 servers: - url: https://api.cometapi.com security: - accessTokenAuth: [] paths: /api/token/{id}: get: summary: Get a single API key description: Retrieve one API key record by ID for the authenticated account. operationId: getApiKey parameters: - name: id in: path required: true description: Numeric API key ID returned by the list endpoint. schema: type: integer responses: '200': description: API key record. content: application/json: schema: type: object required: - success - message - data properties: success: type: boolean message: type: string data: $ref: '#/components/schemas/ApiKey' examples: success: summary: API key record value: success: true message: '' data: id: 1234 user_id: 5678 key: $COMETAPI_KEY status: 1 name: production created_time: 1766102400 accessed_time: 1766102400 expired_time: -1 remain_quota: 100000 unlimited_quota: false model_limits_enabled: false model_limits: '' allow_ips: null used_quota: 0 group: '' cross_group_retry: false x-codeSamples: - lang: curl label: cURL source: |- curl https://api.cometapi.com/api/token/1234 \ -H "Authorization: your-access-token" components: schemas: ApiKey: type: object properties: id: type: integer description: >- Numeric API key ID. Use this value with the get, update, and delete endpoints. example: 1234 user_id: type: integer description: Account user ID that owns the key. example: 5678 key: type: string description: >- API key value returned by the management API. Treat it as a secret and use it as `Authorization: Bearer $COMETAPI_KEY` for model requests. example: $COMETAPI_KEY status: type: integer description: >- Operational status for the key. `1` means enabled, `2` disabled, `3` expired, and `4` exhausted. Only enabled keys are accepted by model endpoints. enum: - 1 - 2 - 3 - 4 example: 1 name: type: string description: User-readable display name for the API key. example: production maxLength: 50 created_time: type: integer description: Unix timestamp in seconds when the key was created. example: 1766102400 accessed_time: type: integer description: >- Unix timestamp in seconds when the key was last used. Newly created keys may show the creation time until first use. example: 1766102400 expired_time: type: integer description: >- Unix timestamp in seconds when the key expires. `-1` means no expiration. example: -1 remain_quota: type: integer description: >- Remaining quota for this key in CometAPI internal quota units. When this reaches `0` and `unlimited_quota` is `false`, model requests are rejected as quota exhausted. example: 100000 unlimited_quota: type: boolean description: Whether the key bypasses remaining-quota checks. example: false model_limits_enabled: type: boolean description: >- Whether model restrictions are active for this key. When `false`, `model_limits` is ignored. example: false model_limits: type: string description: >- Comma-separated model IDs allowed by this key when `model_limits_enabled` is `true`. Empty means no configured model list. example: '' allow_ips: type: - string - 'null' description: >- Optional IP allowlist stored as one newline-separated string. Each entry can be a single IPv4 address, single IPv6 address, IPv4 CIDR, or IPv6 CIDR. Example: `198.51.100.10\n203.0.113.0/24\n2001:db8::/32`. `null` or `""` means IP restrictions are disabled. example: |- 198.51.100.10 203.0.113.0/24 2001:db8::/32 used_quota: type: integer description: Quota already consumed by this key in CometAPI internal quota units. example: 0 group: type: string description: >- Account group restriction for this key. Empty means no explicit group restriction. example: '' cross_group_retry: type: boolean description: >- Whether cross-group retry is enabled for automatic group routing. This is only meaningful when the key uses an auto-routed group such as `auto`. example: false additionalProperties: true securitySchemes: accessTokenAuth: type: apiKey in: header name: Authorization description: >- Personal access token copied from CometAPI Console > Personal Settings. Send the raw token value; do not prefix it with `Bearer`. ````