Skip to main content
GET
https://app.hoox.video
/
api
/
public
/
v1
/
avatar
/
list
curl -X GET "https://app.hoox.video/api/public/v1/avatar/list?gender=male&tags=business,casual" \
  -H "Authorization: Bearer your_api_key"

[
  {
    "id": "look_id",
    "avatar_name": "Avatar name",
    "look_name": "Look name",
    "gender": "male",
    "place": "studio",
    "format": "vertical",
    "tags": ["business"],
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "preview": null,
    "model_available": ["premium", "ultra", "veo-3", "veo-3-fast"]
  },
  {
    "id": "look_id_2",
    "avatar_name": "Avatar name",
    "look_name": "Another Look",
    "gender": "female",
    "place": "office",
    "format": "horizontal",
    "tags": ["casual", "friendly"],
    "thumbnail": "https://cdn.example.com/thumbnail2.jpg",
    "preview": "https://cdn.example.com/preview2.mp4",
    "model_available": ["standard"]
  }
]

​
Overview

This endpoint retrieves a list of available avatar looks. It returns looks from your space first (if any), followed by looks from the public catalog. Results can be filtered by gender and tags.

​
Authentication

This endpoint requires API key authentication. Include your API key in the Authorization header.

​
Query Parameters

​
gender
string
Filter by gender: male or female.
​
tags
string
Filter by tags. Provide a comma-separated list (e.g., business,casual).
​
onlyPublic
boolean
default:"false"
If true, returns only public catalog avatars (excludes custom space avatars). Defaults to false (returns both space and public avatars).

​
Response

Returns an array of avatar look objects.
​
id
string
Unique identifier of the look.
​
avatar_name
string
Name of the avatar.
​
look_name
string
Name of the avatar look.
​
gender
string
Gender of the avatar: male or female.
​
place
string
Place or context of the look (e.g., “studio”, “office”).
​
format
string
Image format: vertical or horizontal.
​
tags
array
Array of tags associated with the look.
​
thumbnail
string
URL of the look thumbnail image.
​
preview
string
Preview URL if available, otherwise null.
​
model_available
array
Array of available models for this look. If preview exists, only standard is available. Otherwise, models like premium, ultra, veo-3, veo-3-fast may be available.
curl -X GET "https://app.hoox.video/api/public/v1/avatar/list?gender=male&tags=business,casual" \
  -H "Authorization: Bearer your_api_key"

[
  {
    "id": "look_id",
    "avatar_name": "Avatar name",
    "look_name": "Look name",
    "gender": "male",
    "place": "studio",
    "format": "vertical",
    "tags": ["business"],
    "thumbnail": "https://cdn.example.com/thumbnail.jpg",
    "preview": null,
    "model_available": ["premium", "ultra", "veo-3", "veo-3-fast"]
  },
  {
    "id": "look_id_2",
    "avatar_name": "Avatar name",
    "look_name": "Another Look",
    "gender": "female",
    "place": "office",
    "format": "horizontal",
    "tags": ["casual", "friendly"],
    "thumbnail": "https://cdn.example.com/thumbnail2.jpg",
    "preview": "https://cdn.example.com/preview2.mp4",
    "model_available": ["standard"]
  }
]

​
Notes

  • By default, looks from your space are returned first, followed by public catalog looks
  • Set onlyPublic=true to return only public catalog looks (excludes custom space avatars)
  • The model_available field indicates which video generation models can be used with this look
  • If a look has a preview URL, it means the look is pre-rendered and only the standard model is available
  • Use the id field as avatar_id when creating videos with the /generation/start endpoint