> ## 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 キー管理エンドポイントでは、別の personal access token を使用します。
</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`.

````