Skip to main content
GET
/
api
/
public
/
v1
/
avatar
/
{avatar_id}
/
look
/
{look_id}
curl -X GET "https://app.hoox.video/api/public/v1/avatar/avtr_abc123/look/look_123" \
  -H "Authorization: Bearer your_api_key"

{
  "id": "look_123",
  "avatar_id": "avtr_abc123",
  "avatar_name": "Alex",
  "look_name": "Office Look",
  "gender": "male",
  "place": "office",
  "format": "vertical",
  "tags": ["business", "professional"],
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "preview": null,
  "model_available": ["premium", "ultra", "veo-3-fast", "veo-3", "veo-3-lite", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast"],
  "status": "ready",
  "error_message": null
}

​
Overview

This endpoint retrieves details for a specific look of an avatar. Use this to get full information about a particular look including available models and generation status.

​
Authentication

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

​
Path Parameters

​
avatar_id
string
required
The unique identifier of the avatar.
​
look_id
string
required
The unique identifier of the look to retrieve.

​
Response

​
id
string
Unique identifier of the look.
​
avatar_id
string
Unique identifier of the parent avatar.
​
avatar_name
string
Name of the avatar.
​
look_name
string
Name of the 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
Available models for this look. Possible values: standard, premium, ultra, veo-3-fast, veo-3, veo-3-lite, ora-lite, ora-standard, ora-pro, seedance-2, seedance-2-fast.
​
status
string
Current status: ready, pending, or error.
​
error_message
string
Error message if status is error.
curl -X GET "https://app.hoox.video/api/public/v1/avatar/avtr_abc123/look/look_123" \
  -H "Authorization: Bearer your_api_key"

{
  "id": "look_123",
  "avatar_id": "avtr_abc123",
  "avatar_name": "Alex",
  "look_name": "Office Look",
  "gender": "male",
  "place": "office",
  "format": "vertical",
  "tags": ["business", "professional"],
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "preview": null,
  "model_available": ["premium", "ultra", "veo-3-fast", "veo-3", "veo-3-lite", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast"],
  "status": "ready",
  "error_message": null
}