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

# Dapatkan API key saat ini

> Gunakan CometAPI GET /api/usage/token untuk mengambil detail kuota, penggunaan, kedaluwarsa, dan batas model untuk bearer API key.

Gunakan endpoint ini untuk memeriksa CometAPI API key yang digunakan oleh permintaan. Endpoint ini mengembalikan kolom penggunaan dan kuota untuk bearer key, bukan daftar semua key pada tingkat akun.

<Note>
  Endpoint ini menggunakan CometAPI API key: `Authorization: Bearer $COMETAPI_KEY`. Endpoint pengelolaan API key menggunakan personal access token yang terpisah.
</Note>

## Kolom yang dikembalikan

| Field                  | Type    | Description                                                                                                              |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------------------------ |
| `name`                 | string  | Nama tampilan API key.                                                                                                   |
| `total_granted`        | integer | Total kuota yang ditetapkan untuk key ini dalam satuan kuota internal CometAPI.                                          |
| `total_used`           | integer | Kuota yang telah digunakan oleh key ini dalam satuan kuota internal CometAPI.                                            |
| `total_available`      | integer | Sisa kuota yang tersedia untuk key ini dalam satuan kuota internal CometAPI.                                             |
| `unlimited_quota`      | boolean | Apakah key ini melewati pemeriksaan sisa kuota.                                                                          |
| `model_limits`         | object  | Pembatasan model untuk key ini, dengan kunci berdasarkan model ID. Kosong jika tidak ada batas model yang dikonfigurasi. |
| `model_limits_enabled` | boolean | Apakah pembatasan model aktif untuk key ini.                                                                             |
| `expires_at`           | integer | Unix timestamp dalam detik saat key kedaluwarsa. `0` berarti tidak ada kedaluwarsa dalam respons penggunaan ini.         |


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

````