> ## 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. # Lister les clés API > Utilisez CometAPI GET /api/token/ pour lister les clés API du compte authentifié avec pagination. Utilisez ce endpoint pour lister les clés API appartenant au compte CometAPI authentifié. Les clés les plus récentes sont renvoyées en premier. 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`. ## Pagination | Paramètre de requête | Description | | -------------------- | ------------------------------------------------------------------------------------ | | `p` | Numéro de page. La valeur par défaut est `1`. | | `page_size` | Nombre d’éléments par page. Les valeurs supérieures à `100` sont plafonnées à `100`. | ## Statut des clés API | Statut | Signification | | ------ | ------------- | | `1` | Activée | | `2` | Désactivée | | `3` | Expirée | | `4` | Épuisée | ## Champs renvoyés | Champ | Type | Description | | ---------------------- | -------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `id` | integer | ID numérique de la clé API. Utilisez cette valeur avec [Obtenir une clé API unique](./get-api-key), [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 au moment de la création de la clé. | | `accessed_time` | integer | Horodatage Unix en secondes de la dernière utilisation de la clé. | | `expired_time` | integer | Horodatage Unix en secondes à l’expiration de la clé. `-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` est `true`. Une valeur vide signifie qu’aucune liste de modèles n’est configurée. | | `allow_ips` | string or null | Liste d’autorisation d’IP sous forme d’une chaîne unique séparée par des retours à la 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 du compte. Une valeur vide signifie qu’aucune restriction de groupe explicite n’est définie. | | `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/list-api-keys.openapi.json GET /api/token/ openapi: 3.1.0 info: title: List API Keys version: 1.0.0 servers: - url: https://api.cometapi.com security: - accessTokenAuth: [] paths: /api/token/: get: summary: List API keys description: >- List API keys for the authenticated account. The newest keys are returned first. operationId: listApiKeys parameters: - name: p in: query required: false description: Page number to return. Defaults to `1`. schema: type: integer minimum: 1 default: 1 - name: page_size in: query required: false description: >- Number of keys per page. Values above `100` are capped at `100` by the backend. schema: type: integer minimum: 1 maximum: 100 default: 20 responses: '200': description: Paginated API key list. content: application/json: schema: type: object required: - success - message - data properties: success: type: boolean message: type: string data: type: object required: - page - page_size - total - items properties: page: type: integer page_size: type: integer total: type: integer items: type: array items: $ref: '#/components/schemas/ApiKey' examples: success: summary: API key list value: success: true message: '' data: page: 1 page_size: 20 total: 1 items: - 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/?p=1&page_size=20" \ -H "Authorization: your-access-token" components: schemas: ApiKey: $ref: '#/components/schemas/ApiKeyObject' ApiKeyObject: 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`. ````