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

type
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)
limit
integer
default:"20"
Maximum number of avatars to return per page.Range: 1-100
offset
integer
default:"0"
Number of avatars to skip (for pagination).Minimum: 0

Response

avatars
array
required
List of avatar objects.
pagination
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.