Customize every aspect of your generated avatar using parameters.
The type of character to generate.
{
"parameters": {
"subject": "fox"
}
}
Available subjects:
| Category | Options |
|---|---|
| Animals | fox, cat, dog, wolf, bear, owl, rabbit |
| Fantasy | dragon, unicorn, phoenix, griffin |
| Human | human (use with gender and other attributes) |
The character's outfit, role, or setting.
{
"parameters": {
"theme": "warrior"
}
}
Available themes:
| Category | Options |
|---|---|
| Fantasy | warrior, wizard, knight, ranger, healer |
| Modern | casual, business, athletic, artistic |
| Sci-Fi | astronaut, cyborg, pilot |
| Nature | forest, ocean, mountain, desert |
Gender presentation of the character.
{
"parameters": {
"gender": "female"
}
}
Options: male, female, neutral
Primary color theme for the character.
{
"parameters": {
"color": "orange"
}
}
Available colors:
red, orange, yellow, green, blue, purple, pinkwhite, black, gray, browngold, silver, rainbowUse a seed for reproducible results.
{
"parameters": {
"subject": "fox",
"theme": "warrior",
"gender": "female",
"color": "orange",
"seed": 12345
}
}
{
"style_id": "pixar-3d",
"parameters": {
"subject": "owl",
"theme": "wizard",
"gender": "neutral",
"color": "purple"
}
}
{
"style_id": "anime",
"parameters": {
"subject": "wolf",
"theme": "knight",
"gender": "male",
"color": "silver"
}
}
{
"style_id": "realistic",
"parameters": {
"subject": "human",
"theme": "business",
"gender": "female",
"color": "blue"
}
}
{
"style_id": "watercolor",
"parameters": {
"subject": "dragon",
"theme": "forest",
"gender": "neutral",
"color": "green"
}
}
Parameters affect generation differently at each quality level:
| Quality | Detail Level | Best For |
|---|---|---|
economy | Basic features, less detail | Prototyping, bulk |
standard | Full features, good detail | Production use |
high | Maximum detail, refined | Hero images |
| Size | Result |
|---|---|
square | Centered character, full portrait |
landscape | Character with environment |
portrait | Full-body or dramatic pose |
Invalid parameters return clear error messages:
{
"statusCode": 400,
"message": "Parameter validation failed: subject 'unicycle' is not a valid option"
}