> ## 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. # Listar chaves de API > Use o CometAPI GET /api/token/ para listar chaves de API da conta autenticada com paginação. Use este endpoint para listar as chaves de API que pertencem à conta CometAPI autenticada. As chaves mais recentes são retornadas primeiro. Gere um personal access token em [Console → Personal Settings](https://www.cometapi.com/console/personal) e, em seguida, envie-o como o valor bruto do cabeçalho `Authorization`. Não adicione o prefixo `Bearer`. ## Paginação | Query parameter | Description | | --------------- | --------------------------------------------------------------- | | `p` | Número da página. O padrão é `1`. | | `page_size` | Itens por página. Valores acima de `100` são limitados a `100`. | ## Status da chave de API | Status | Meaning | | ------ | ---------- | | `1` | Ativada | | `2` | Desativada | | `3` | Expirada | | `4` | Esgotada | ## Campos retornados | Field | Type | Description | | ---------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | | `id` | integer | ID numérico da chave de API. Use este valor com [Obter uma única chave de API](./get-api-key), [Atualizar uma chave de API](./update-api-key) e [Excluir uma chave de API](./delete-api-key). | | `key` | string | Valor da chave de API retornado pela API de gerenciamento. Trate-o como um segredo e use-o como `Authorization: Bearer $COMETAPI_KEY` para solicitações de modelo. | | `status` | integer | Status operacional. Somente `1` significa que a chave está ativada para solicitações de modelo. | | `name` | string | Nome de exibição legível pelo usuário para a chave. | | `created_time` | integer | Timestamp Unix em segundos de quando a chave foi criada. | | `accessed_time` | integer | Timestamp Unix em segundos de quando a chave foi usada pela última vez. | | `expired_time` | integer | Timestamp Unix em segundos de quando a chave expira. `-1` significa sem expiração. | | `remain_quota` | integer | Cota restante em unidades internas de cota do CometAPI. | | `used_quota` | integer | Cota já consumida por esta chave em unidades internas de cota do CometAPI. | | `unlimited_quota` | boolean | Se a chave ignora verificações de cota restante. | | `model_limits_enabled` | boolean | Se as restrições de modelo estão ativas para esta chave. | | `model_limits` | string | model IDs separados por vírgula permitidos por esta chave quando `model_limits_enabled` é `true`. Vazio significa que não há lista de modelos configurada. | | `allow_ips` | string or null | Lista de IPs permitidos como uma única string separada por quebras de linha. Cada entrada pode ser um único endereço IPv4, um único endereço IPv6, um CIDR IPv4 ou um CIDR IPv6. `null` ou `""` significa sem restrição de IP. | | `group` | string | Restrição de grupo da conta. Vazio significa sem restrição explícita de grupo. | | `cross_group_retry` | boolean | Se a repetição entre grupos está ativada para roteamento automático de grupos. | ## 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`. ````