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",
  "age_range": "adult",
  "ethnicity": "white-western-european",
  "hair_color": "brown",
  "place": "office",
  "accessories": ["laptop"],
  "action": "working",
  "emotion": "focused",
  "selfie": false,
  "format": "vertical",
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "preview": null,
  "model_available": ["premium", "ultra", "veo-3-fast", "veo-3", "veo-3-lite", "omni-flash", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast", "seedance-2-1080p"],
  "status": "ready",
  "error_message": null
}

Documentation Index

Fetch the complete documentation index at: https://docs.hoox.video/llms.txt

Use this file to discover all available pages before exploring further.

​
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.
​
age_range
string
Avatar age range.
​
ethnicity
string
Avatar ethnicity.
​
hair_color
string
Avatar hair color.
​
place
string
Place or context of the look (e.g., “studio”, “office”).
​
accessories
array
Visible accessories or props in the look.
​
action
string
Main action detected for the look.
​
emotion
string
Emotion or mood detected for the look.
​
selfie
boolean
Whether the look is a selfie-style shot.
​
format
string
Image format: vertical or horizontal.
​
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, omni-flash, ora-lite, ora-standard, ora-pro, seedance-2, seedance-2-fast, seedance-2-1080p.
​
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",
  "age_range": "adult",
  "ethnicity": "white-western-european",
  "hair_color": "brown",
  "place": "office",
  "accessories": ["laptop"],
  "action": "working",
  "emotion": "focused",
  "selfie": false,
  "format": "vertical",
  "thumbnail": "https://cdn.example.com/thumbnail.jpg",
  "preview": null,
  "model_available": ["premium", "ultra", "veo-3-fast", "veo-3", "veo-3-lite", "omni-flash", "ora-lite", "ora-standard", "ora-pro", "seedance-2", "seedance-2-fast", "seedance-2-1080p"],
  "status": "ready",
  "error_message": null
}