---
title: "Get Streaming Avatar List"
method: GET
path: "/api/open/v4/liveAvatar/avatar/list"
tags: ["Avatar Management"]
---

# Get Streaming Avatar List

`GET /api/open/v4/liveAvatar/avatar/list`

Retrieve a list of available streaming avatars

## Query parameters

- `platform` 'open' | 'aigc'
- `page` integer
- `size` integer

## Response `200`

List of streaming avatars

- object
  - `code` integer, required — Interface returns business status code (1000: success)
  - `msg` string, required — Interface returns status information
  - `data` AvatarListResponse
    - `count` integer — Total number of streaming avatars
    - `result` Avatar[]
      - `_id` string — Internal ID
      - `uid` integer — User ID
      - `type` integer — Avatar type identifier (2 for streaming avatars)
      - `from` integer — Source identifier for the avatar, 2 for official and 3 for user created
      - `avatar_id` string — Unique identifier for the streaming avatar
      - `voice_id` string — Associated voice model identifier
      - `name` string — Display name of the avatar
      - `url` string — URL to access the streaming avatar
      - `thumbnailUrl` string — URL for the avatar's preview thumbnail
      - `gender` string — Avatar's gender designation
      - `available` boolean — Indicates if the avatar is currently available for use

---

[API](https://skmtc.dev/akool/apis/face-detection-api.md) · [All operations](https://skmtc.dev/akool/apis/face-detection-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/akool/face-detection-api/revisions/ce2ff5679949/schema)