Skip to main content
GET
Retrieves a paginated list of avatars. You can request either realistic (public) avatars available to all users, or your custom avatars.

Query Parameters

string
required
The type of avatars to retrieve.Allowed values: realistic, custom
  • realistic: Public avatars available to all users
  • custom: Your custom avatars (uploaded or AI-generated)
integer
default:"20"
Maximum number of avatars to return per page.Range: 1-100
integer
default:"0"
Number of avatars to skip (for pagination).Minimum: 0

Response

array
required
List of avatar objects.
object
required
Pagination information.

Usage with Video Creation

Once you’ve retrieved the avatar list, use the avatar id when creating videos:

Error Codes

See Error Handling for more details.