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

# List Kling voices

> Find official preset voice IDs or the private voices available to your workspace.

Use your GENGEN API key to try this free request. Choose `scope=preset` for Kling's official voices (the default) or `scope=private` for active voices created in your workspace. If the response includes a `nextPage` number, pass it as `page` with the same scope. Stop when `nextPage` is `null`.

Listen to `previewUrl` when present. To use the voice in a [Kling 4.0 video](https://docs.gengen.farm/api-reference/kling/4.0/create-task.md), copy its `voiceId` **as a string**. Choose a separate `id` for the prompt to reference with `@`. For example, if you choose `narrator`, refer to the voice as `@narrator`:

```json theme={"dark"}
{
  "model": "kling-4.0",
  "mode": "omni_video",
  "prompt": "In @narrator's voice, say: Welcome to the show.",
  "assets": { "voices": [{ "voiceId": "829837252279803904", "id": "narrator" }] }
}
```

To use your own recording, [create a private voice](https://docs.gengen.farm/api-reference/kling/4.0/create-voice.md) and [check its status](https://docs.gengen.farm/api-reference/kling/4.0/get-voice-operation.md). You can [delete a private voice](https://docs.gengen.farm/api-reference/kling/4.0/delete-voice.md) to free a slot.


## OpenAPI

````yaml openapi/kling-40-video.yaml GET /video/kling/voices
openapi: 3.1.0
info:
  title: Kling 4.0 Video API
  version: 1.0.0
  description: >-
    Supports text-to-video, image keyframes and Omni references/editing.
    Authenticate with a GENGEN API key.
servers:
  - url: https://gengen.farm/api/gengen/v1
security:
  - bearerAuth: []
paths:
  /video/kling/voices:
    get:
      summary: List Kling voices
      description: >-
        Free directory lookup. Use a GENGEN API key from the workspace whose
        private voices you want to list.
      operationId: listKlingVoices
      parameters:
        - name: scope
          in: query
          description: >-
            Use preset for official Kling voices or private for active voices
            created in this workspace.
          schema:
            type: string
            enum:
              - preset
              - private
            default: preset
        - name: page
          in: query
          description: >-
            One-based page number. For subsequent requests use the previous
            response's nextPage.
          schema:
            type: integer
            minimum: 1
            maximum: 1000
            default: 1
        - name: pageSize
          in: query
          description: Number of entries to request per page.
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 30
      responses:
        '200':
          description: A page of voices from the selected directory.
          content:
            application/json:
              schema:
                type: object
                required:
                  - voices
                  - nextPage
                properties:
                  voices:
                    type: array
                    description: Voices available on this page. The array can be empty.
                    items:
                      type: object
                      required:
                        - voiceId
                        - name
                      properties:
                        voiceId:
                          $ref: '#/components/schemas/VoiceId'
                        name:
                          type: string
                          description: Display name of the voice.
                        previewUrl:
                          $ref: '#/components/schemas/VoicePreviewUrl'
                  nextPage:
                    type:
                      - integer
                      - 'null'
                    description: Next page number, or null when pagination is complete.
              example:
                voices:
                  - voiceId: '829837252279803904'
                    name: Laura
                nextPage: null
        '400':
          description: Invalid scope or pagination.
        '401':
          $ref: '#/components/responses/VoiceUnauthorized'
components:
  schemas:
    VoiceId:
      type: string
      minLength: 1
      maxLength: 128
      pattern: ^[A-Za-z0-9_-]+$
      description: >-
        Kling's voice ID. Preserve it as a string, including when it contains
        only digits. Pass it in assets.voices[].voiceId.
    VoicePreviewUrl:
      type: string
      format: uri
      description: Optional HTTPS link to an audio preview. Open it to listen to the voice.
  responses:
    VoiceUnauthorized:
      description: A valid GENGEN bearer API key is required.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: GENGEN API key

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.