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

# List voices

> The voice catalog for a model. **Open** — no API key required.



## OpenAPI

````yaml /openapi.json get /v1/voices
openapi: 3.0.3
info:
  title: geko API
  version: 1.0.0
  description: >-
    Text-to-speech for Kazakh and beyond. Send text and a voice name; get back
    WAV audio (24 kHz, 16-bit PCM, mono). A thin, familiar HTTP API — call it
    from any language, or use the typed SDK and CLI.


    The catalog endpoints (`/v1/models`, `/v1/voices`, `/health`) are open.
    Synthesis endpoints require a bearer key — create one in the
    [console](https://app.geko.sh).
servers:
  - url: https://geko--tokay-serve-web.modal.run
security:
  - bearerAuth: []
paths:
  /v1/voices:
    get:
      tags:
        - Catalog
      summary: List voices
      description: The voice catalog for a model. **Open** — no API key required.
      operationId: listVoices
      parameters:
        - name: model
          in: query
          required: false
          description: Model id. Defaults to `tokay-kk-v1`.
          schema:
            type: string
            default: tokay-kk-v1
      responses:
        '200':
          description: The voice catalog for the requested model.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/VoicesResponse'
      security: []
components:
  schemas:
    VoicesResponse:
      type: object
      properties:
        model:
          type: string
          example: tokay-kk-v1
        voices:
          type: array
          items:
            $ref: '#/components/schemas/Voice'
    Voice:
      type: object
      properties:
        name:
          type: string
          example: Aigerim
        gender:
          type: string
          nullable: true
          example: female
        style:
          type: string
          nullable: true
          example: Warm, professional
        best_for:
          type: string
          nullable: true
          example: Reception, customer support
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Your geko API key (`sk-tokay-…`). Create and manage keys in the
        [console](https://app.geko.sh).

````