List avatars

January 12, 2026 (October 20, 2026)

Table of contents

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

This endpoint retrieves a list of avatars. You can list either your personal saved avatars or browse system-provided templates.

Avatars are digital characters that can be animated with lip-sync using POST /avatars/video.

https://api.useapi.net/v1/kling/avatars/?…

Request Headers 
Authorization: Bearer {API token}
Query Parameters

  • email is optional. Without it, one of your accounts is used (429 while every account is at its maxJobs).
    Personal avatars belong to the account that saved them, so pass email to list a specific account’s avatars.

  • type is optional, the type of avatars to list. Supported values: personal (default), templates.

    • personal: Your saved avatars created via POST /avatars
    • templates: System-provided avatar templates
Responses

  • 200 OK

    Personal avatars response (type=personal):

    [
  {
    "id": "123456789012",
    "nickname": "My Fashion Avatar",
    "prompt": "Elegant woman in professional attire",
    "scene": "advertising_marketing",
    "imageResources": [
      {
        "url": "https://s21-kling.klingai.com/ai-platform/.../avatar.jpg",
        "sourceFrom": 2
      }
    ],
    "ttsSpeaker": "speaker_id_123",
    "ttsSpeed": "1",
    "ttsEmotionKey": "neutral",
    "createTime": 1736640000000,
    "updateTime": 1736640000000
  }
]

    Templates response (type=templates):

    [
  {
    "id": "12345",
    "name": "Business Woman",
    "imageResources": [
      {
        "url": "https://s21-kling.klingai.com/ai-platform/.../template.jpg"
      }
    ],
    "prompt": "Professional businesswoman in formal attire"
  }
]

  • 401 Unauthorized

    {
  "error": "Unauthorized",
  "code": 401
}
Model 
Array<{
  id: string
  nickname?: string
  name?: string
  prompt: string
  scene?: string
  imageResources: {
    url: string
    sourceFrom?: number
  }[]
  ttsSpeaker?: string
  ttsSpeed?: string
  ttsEmotionKey?: string
  createTime?: number
  updateTime?: number
}>
Avatar ID Format
  • Personal avatars have long IDs (more than 8 digits), e.g., 123456789012
  • Template avatars have short IDs (8 digits or fewer), e.g., 12345

This distinction is used internally when generating avatar videos.

Examples 
  • curl "https://api.useapi.net/v1/kling/avatars/[email protected]&type=personal" \
   -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/avatars/?email=${email}&type=personal`;
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/avatars/?email={email}&type=personal"
headers = {
    "Authorization" : f"Bearer {token}"
}
response = requests.get(apiUrl, headers=headers)
print(response, response.json())
Try It