Retrieve available element voices

February 9, 2026

Table of contents

  1. Request Headers
  2. Query Parameters
  3. Responses
  4. Model
  5. Examples
  6. Try It

This endpoint retrieves available official voices for elements. Voices can be assigned to elements when creating them via POST /elements. Only elements with the character tag support voice assignment.

https://api.useapi.net/v1/kling/elements/voices/?…

Request Headers
Authorization: Bearer {API token}
Query Parameters
  • email is optional when only one account configured. However, if you have multiple accounts configured, this parameter becomes required.
Responses
  • 200 OK

    {
      "voices": [
        {
          "id": 1,
          "name": "Vivid Girl"
        },
        {
          "id": 2,
          "name": "Gentle Lady"
        },
        {
          "id": 3,
          "name": "Charming Uncle"
        }
      ]
    }
    
  • 401 Unauthorized

    {
      "error": "Unauthorized",
      "code": 401
    }
    
Model
{ // TypeScript, all fields are optional
  voices: {
    id: number
    name: string
  }[]
}

Use the id or name value in the voice parameter when creating VIDEO elements via POST /elements.

Examples
  • curl "https://api.useapi.net/v1/kling/elements/voices/[email protected]" \
       -H "Accept: application/json" \
       -H "Authorization: Bearer ..."
    
  • const token = "API token";
    const email = "Previously configured account email";
    const apiUrl = `https://api.useapi.net/v1/kling/elements/voices/?email=${email}`;
    const response = await fetch(apiUrl, {
      headers: {
        "Authorization": `Bearer ${token}`,
      },
    });
    const result = await response.json();
    console.log("response", {response, result});
    
  • import requests
    token = "API token"
    email = "Previously configured account email"
    apiUrl = f"https://api.useapi.net/v1/kling/elements/voices/?email={email}"
    headers = {
        "Authorization" : f"Bearer {token}"
    }
    response = requests.get(apiUrl, headers=headers)
    print(response, response.json())
    
Try It