> ## 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.

# Obtener la API key actual

> Usa CometAPI GET /api/usage/token para recuperar detalles de cuota, uso, vencimiento y límites de modelo para la API key bearer.

Usa este endpoint para inspeccionar la API key de CometAPI utilizada por la solicitud. Devuelve campos de uso y cuota para la key bearer, no una lista a nivel de cuenta de todas las keys.

<Note>
  Este endpoint usa una API key de CometAPI: `Authorization: Bearer $COMETAPI_KEY`. Los endpoints de gestión de API keys usan un token de acceso personal independiente.
</Note>

## Campos devueltos

| Field                  | Type    | Description                                                                                                             |
| ---------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------- |
| `name`                 | string  | Nombre para mostrar de la API key.                                                                                      |
| `total_granted`        | integer | Cuota total asignada a esta key en unidades internas de cuota de CometAPI.                                              |
| `total_used`           | integer | Cuota consumida por esta key en unidades internas de cuota de CometAPI.                                                 |
| `total_available`      | integer | Cuota restante disponible para esta key en unidades internas de cuota de CometAPI.                                      |
| `unlimited_quota`      | boolean | Si la key omite las comprobaciones de cuota restante.                                                                   |
| `model_limits`         | object  | Restricciones de modelo para esta key, indexadas por model ID. Vacío cuando no hay límites de modelo configurados.      |
| `model_limits_enabled` | boolean | Si las restricciones de modelo están activas para esta key.                                                             |
| `expires_at`           | integer | Marca de tiempo Unix en segundos en la que vence la key. `0` significa que no hay vencimiento en esta respuesta de uso. |


## OpenAPI

````yaml api/openapi/api-keys/get-current-api-key.openapi.json GET /api/usage/token
openapi: 3.1.0
info:
  title: Get Current API Key
  version: 1.0.0
servers:
  - url: https://api.cometapi.com
security:
  - bearerAuth: []
paths:
  /api/usage/token:
    get:
      summary: Get current API key
      description: >-
        Retrieve usage, quota, expiration, and model-limit details for the
        CometAPI API key sent in the bearer Authorization header.
      operationId: getCurrentApiKey
      responses:
        '200':
          description: Current API key usage details.
          content:
            application/json:
              schema:
                type: object
                required:
                  - code
                  - message
                  - data
                properties:
                  code:
                    type: boolean
                    description: Whether the request succeeded.
                  message:
                    type: string
                    description: Status message.
                  data:
                    type: object
                    required:
                      - object
                      - name
                      - total_granted
                      - total_used
                      - total_available
                      - unlimited_quota
                      - model_limits
                      - model_limits_enabled
                      - expires_at
                    properties:
                      object:
                        type: string
                        description: Object type.
                        example: token_usage
                      name:
                        type: string
                        description: >-
                          Display name of the bearer API key used by the
                          request.
                        example: production
                      total_granted:
                        type: integer
                        description: >-
                          Total quota assigned to this key in CometAPI internal
                          quota units.
                        example: 150000
                      total_used:
                        type: integer
                        description: >-
                          Quota consumed by this key in CometAPI internal quota
                          units.
                        example: 50000
                      total_available:
                        type: integer
                        description: >-
                          Remaining quota available to this key in CometAPI
                          internal quota units.
                        example: 100000
                      unlimited_quota:
                        type: boolean
                        description: Whether the key bypasses remaining-quota checks.
                        example: false
                      model_limits:
                        type: object
                        description: >-
                          Model restrictions for this key, keyed by model ID.
                          Empty when no model limits are configured.
                        additionalProperties:
                          type: boolean
                        example: {}
                      model_limits_enabled:
                        type: boolean
                        description: Whether model restrictions are active for this key.
                        example: false
                      expires_at:
                        type: integer
                        description: >-
                          Unix timestamp in seconds when the key expires. `0`
                          means no expiration in this usage response.
                        example: 0
              examples:
                success:
                  summary: Current key usage
                  value:
                    code: true
                    message: ok
                    data:
                      object: token_usage
                      name: production
                      total_granted: 150000
                      total_used: 50000
                      total_available: 100000
                      unlimited_quota: false
                      model_limits:
                        gpt-4.1: true
                      model_limits_enabled: true
                      expires_at: 0
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl https://api.cometapi.com/api/usage/token \
              -H "Authorization: Bearer $COMETAPI_KEY"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: CometAPI API key
      description: >-
        CometAPI API key used for model requests. Send it as `Authorization:
        Bearer $COMETAPI_KEY`.

````