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

# 取得目前的 API 金鑰

> 使用 CometAPI GET /api/usage/token 取得 bearer API 金鑰的配額、使用量、到期時間與模型限制詳細資訊。

使用此端點可檢視該請求所使用的 CometAPI API 金鑰。它會回傳此 bearer 金鑰的使用量與配額欄位，而不是帳戶層級的所有金鑰清單。

<Note>
  此端點使用 CometAPI API 金鑰：`Authorization: Bearer $COMETAPI_KEY`。API 金鑰管理端點則使用另一個個人存取權杖。
</Note>

## 回傳欄位

| Field                  | Type    | Description                             |
| ---------------------- | ------- | --------------------------------------- |
| `name`                 | string  | API 金鑰的顯示名稱。                            |
| `total_granted`        | integer | 以 CometAPI 內部配額單位表示，指派給此金鑰的總配額。         |
| `total_used`           | integer | 以 CometAPI 內部配額單位表示，此金鑰已消耗的配額。          |
| `total_available`      | integer | 以 CometAPI 內部配額單位表示，此金鑰剩餘可用的配額。         |
| `unlimited_quota`      | boolean | 此金鑰是否略過剩餘配額檢查。                          |
| `model_limits`         | object  | 此金鑰的模型限制，依 model ID 作為鍵。未設定任何模型限制時為空。   |
| `model_limits_enabled` | boolean | 此金鑰的模型限制是否已啟用。                          |
| `expires_at`           | integer | 此金鑰到期的 Unix 時間戳（秒）。在此使用量回應中，`0` 表示不會到期。 |


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

````