> ## Documentation Index
> Fetch the complete documentation index at: https://docs.breezeblue.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get the current API key

> Return the API key that authenticated this request, including its status and Key Budget counters. Use it to check whether a key is still usable before starting work. The budget is read fresh on every call, no credits are reserved, and an exhausted budget still returns 200 with credit_remaining at 0. Browser sessions are not accepted on this endpoint.



## OpenAPI

````yaml /openapi.json get /v1/api-keys/current
openapi: 3.1.0
info:
  title: Breeze Developer API
  description: >-
    Breeze Developer API for models, voices, text-to-speech, history, balance,
    usage, and browser-managed API keys.
  version: 1.0.0
servers:
  - url: https://api.breeze.blue
security: []
tags:
  - name: Models
    description: Supported TTS models.
  - name: Text to Speech
    description: Text-to-speech synthesis and instruction enhancement.
  - name: Voices
    description: Saved voices and voice settings.
  - name: Voice Previews
    description: Create, audition, and save temporary voice previews.
  - name: Account
    description: Balance, usage, and API keys.
  - name: History
    description: Generated audio history.
paths:
  /v1/api-keys/current:
    get:
      tags:
        - Account
      summary: Get the current API key
      description: >-
        Return the API key that authenticated this request, including its status
        and Key Budget counters. Use it to check whether a key is still usable
        before starting work. The budget is read fresh on every call, no credits
        are reserved, and an exhausted budget still returns 200 with
        credit_remaining at 0. Browser sessions are not accepted on this
        endpoint.
      operationId: api_keys_current
      responses:
        '200':
          description: The authenticating API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CurrentApiKeyResponse'
          headers:
            x-breeze-api-key-id:
              description: >-
                Public API key identifier used to authenticate the request, when
                an API key was used.
              schema:
                type: string
        '401':
          description: HTTP 401 error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - ApiKeyAuth: []
      x-codeSamples:
        - lang: cURL
          label: cURL
          source: |-
            curl \
              --request GET \
              --url "https://api.breeze.blue/v1/api-keys/current" \
              --header "xi-api-key: $BREEZE_API_KEY"
components:
  schemas:
    CurrentApiKeyResponse:
      properties:
        api_key:
          $ref: '#/components/schemas/CurrentApiKey'
      required:
        - api_key
      title: CurrentApiKeyResponse
      type: object
    ErrorResponse:
      properties:
        ok:
          default: false
          title: Ok
          type: boolean
        code:
          title: Code
          type: string
        detail:
          title: Detail
          type: string
        error:
          title: Error
          type: string
        meta:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          default: null
          title: Meta
      required:
        - code
        - detail
        - error
      title: ErrorResponse
      type: object
    CurrentApiKey:
      properties:
        id:
          description: Public API key identifier (key_id).
          title: Id
          type: string
        name:
          title: Name
          type: string
        prefix:
          title: Prefix
          type: string
        status:
          description: 'Key status: active or expiring.'
          title: Status
          type: string
        credit_limit:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          description: Key Budget limit in credits; null when the key has no finite budget.
          title: Credit Limit
        credit_used:
          default: 0
          description: Credits captured against the key since its last reset.
          title: Credit Used
          type: number
        credit_reserved:
          default: 0
          description: Credits reserved by in-flight requests on this key.
          title: Credit Reserved
          type: number
        credit_remaining:
          anyOf:
            - type: number
            - type: 'null'
          default: null
          description: >-
            Credits still available on the key (limit - used - reserved, floored
            at 0); null when the key has no finite budget.
          title: Credit Remaining
      required:
        - id
        - name
        - prefix
        - status
      title: CurrentApiKey
      type: object
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: xi-api-key
      description: Breeze Developer API key.

````