> ## 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 لاسترجاع تفاصيل الحصة والاستخدام وانتهاء الصلاحية وحدود النموذج لمفتاح API الخاص بالحامل.

استخدم نقطة النهاية هذه لفحص مفتاح CometAPI API المستخدم في الطلب. وهي تعرض حقول الاستخدام والحصة لمفتاح الحامل، وليس قائمة على مستوى الحساب لجميع المفاتيح.

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

````