Model Library

Navigate to AI Studio → Photo Studio → Model library to access this section.

Overview

The model library is the section of Photo Studio where you define reusable AI subjects, called models, that are referenced by scene presets to generate product imagery. A model encodes the consistent appearance of the subject (a person, animal, or custom entity) so that it looks the same across any number of generated images.

Model Library Interface

UI Element	Description
+ New model button	Opens the "Create model" dialog to start a new model definition
Grid view icon	Displays models as image cards (default)
List view icon	Displays models as a data table
Settings (⚙) icon	Configures visible columns in list view
Show selector	Sets how many models per page (default: 25)
Page navigator	Moves between pages of results

Each model card in grid view shows the AI-generated preview image and the model name.

---

Model Types

When clicking + New model, you first select the model type. The type determines the available configuration steps.

Model Type	Best for	Configuration steps
Human	Clothing, accessories, fashion. Offers structured configuration of demographics, face, hair, body, and personal details.	Identity → Face → Hair → Body → Details
Animal	Pet accessories, animal care products, lifestyle content featuring any animal species.	Identity → Appearance → Details
Custom	Any subject not fitting Human or Animal. Full free-form control, describe the model in plain language.	Identity → Model description

---

Human Model - All Fields and Options

Step 1: Identity

Basic demographics like age, gender, and ethnicity.

Field	Required	Type	All Accepted Values / Notes
Model name	Yes	Free text	Any string. Used as display label in the library (e.g., Elena, Studio Model 01)
Model code	Yes	Free text (slug)	Unique system identifier, no spaces (e.g., elena_young_female)
Age	Yes	Number	Any numeric value representing approximate age in years (e.g., 25, 42)
Gender	Yes	Dropdown	Female · Male · Non-binary · Other
Ethnicity hint	Yes	Dropdown	No preference · East Asian · Hispanic / Latino · Indigenous / Native American · Middle Eastern / North African · Mixed Background · Northern European · Pacific Islander · South Asian · Southeast Asian · Southern European / Mediterranean · Sub-Saharan African

Note: No preference means the AI selects ethnicity freely without constraint. All other values bias the generation toward that regional appearance. The field is labelled as a hint, not an absolute rule.

---

Step 2: Face

Facial features, skin tone, and eye color.

The Face step offers two input modes, free-text or the Visual builder.

Mode A - Face description (free text)

Field	Required	Type	Hint
Face description	Yes	Multi-line free text	Describe specific facial features, skin undertones, and eye color or shape.

Example value: Type: Oval. Skin tone: Porcelain. Eye color: Blue.

Mode B - Visual builder (predefined style selectors)

Clicking Visual builder opens a modal with structured pickers that auto-generate the description text.

Face Type (pick one):

Option	Description
Oval	Balanced, slightly longer than wide
Round	Equal width and length, soft angles
Square	Strong jawline, wide forehead
Heart	Wide forehead, narrow chin
Long	Elongated, narrow
Diamond	Narrow forehead and chin, wide cheekbones

Skin Tone (pick one):

Option	Approximate shade
Porcelain	Very light, near white
Ivory	Light with warm undertone
Fair	Light beige
Beige	Neutral medium-light
Honey	Warm golden tan
Tan	Medium brown
Chestnut	Deep warm brown
Espresso	Very deep brown
Ebony	Deepest dark

Eye Color (pick one):

Option
Blue
Green
Hazel
Brown
Black
Gray

Additional field (both modes):

Field	Required	Type	Hint
Face reference photo	No	Image upload	Upload a clear, front-facing portrait to provide a specific facial feature reference for the AI. Leave empty for natural generation.

---

Step 3: Hair

Hair length, texture, and exact color tones.

Same dual-mode as Face - free-text or Visual builder.

Mode A - Hair description (free text)

Field	Required	Type	Hint
Hair description	Yes	Multi-line free text	Add specific details like hair volume, natural parting, fringe, or haircut style.

Example value: Length: Medium. Type: Wavy. Color: Golden.

Mode B - Visual builder

Hair Length (pick one):

Option	Description
Bald	No hair / shaved
Short	Above the ears
Chin	Chin-length bob
Shoulder	Shoulder-length
Medium	Mid-back length
Long	Past mid-back

Hair Type (pick one):

Option	Description
Straight	No curl pattern
Wavy	Gentle S-waves
Curly	Defined curls
Coily	Tight coils / afro texture

Hair Color (pick one):

Option	Approximate shade
Platinum	Very light blonde, near white
Golden	Warm golden blonde
Dark Blonde	Darker blonde
Copper	Warm orange-red
Auburn	Deep reddish brown
Light Brown	Light chestnut
Medium Brown	Classic brown
Dark Brown	Deep chocolate
Black	Natural black
Jet Black	Intense deep black
Silver	Gray / salt-and-pepper
White	Pure white / albino range

---

Step 4: Body

Body type, proportions, and measurements.

Same dual-mode - free-text or Visual builder.

Mode A - Body description (free text)

Field	Required	Type	Hint
Body description	Yes	Multi-line free text	Define body type, height, and proportions to ensure the right fit for your product.

Example value: Physique: Average. Height: 173. Chest: 75. Waist: 60. Hips: 75. Cup size: B (Medium).

Mode B - Visual builder

Physique (pick one):

Option	Description
Slim	Lean, narrow frame
Athletic	Toned, muscular definition
Average	Balanced, typical proportions
Curvy	Defined waist with fuller hips and bust
Plus Size	Fuller figure throughout
Muscular	Heavily built, prominent muscle mass

Measurements (numeric, in cm):

Field	Required	Type	Notes
Height	No	Number (cm)	Model's height in centimeters
Chest	No	Number (cm)	Chest circumference
Waist	No	Number (cm)	Waist circumference
Hips	No	Number (cm)	Hip circumference

Cup size (dropdown, pick one):

Option	Label
AA (Very Small)	Very Small
A (Small)	Small
B (Medium)	Medium
C (Full)	Full
D (Large)	Large
DD / E (Very Large)	Very Large
F+ (Extra Large)	Extra Large

Note: Cup size is gender-contextual and only relevant for Female or Non-binary models wearing clothing with bust area.

---

Step 5: Details

Unique traits like tattoos, piercings, or freckles.

Field	Required	Type	Hint
Description	No	Multi-line free text	Add unique characteristics like freckles, tattoos, or specific makeup styles.

No Visual builder. Fully free-form. Leave empty for a neutral appearance with no distinguishing marks.

Example values: Small tattoo on left wrist. Light freckles across nose. · Bold red lipstick, cat-eye eyeliner.

---

Human Model - Step Summary

Step	Section title	Subtitle	Required fields	Optional fields
1	Identity	Basic demographics like age, gender, and ethnicity.	Model name, Model code, Age, Gender, Ethnicity hint	—
2	Face	Facial features, skin tone, and eye color.	Face description (or Visual builder selection)	Face reference photo
3	Hair	Hair length, texture, and exact color tones.	Hair description (or Visual builder selection)	—
4	Body	Body type, proportions, and measurements.	Body description (or Visual builder selection)	All measurement fields
5	Details	Unique traits like tattoos, piercings, or freckles.	—	Description

---

Animal Model - All Fields and Options

Step 1: Identity

Basic information to identify and categorize the animal.

Field	Required	Type	All Accepted Values / Notes
Model name	Yes	Free text	Display name (e.g., Buddy, Whiskers)
Model code	Yes	Free text (slug)	Unique system identifier (e.g., buddy_golden_retriever)
Species	Yes	Free text	Any species name (e.g., Dog, Cat, Horse, Parrot, Rabbit)
Breed	No	Free text	Specific breed within the species (e.g., Golden Retriever, Persian, Thoroughbred)
Age	Yes	Number or text	Age or life-stage (e.g., 3, Puppy, Senior)
Sex	No	Dropdown	Female · Male

---

Step 2: Appearance

Coat, coloring, eye color, and overall look.

No Visual builder for Animal - all free text.

Field	Required	Type	Hint
Appearance description	Yes	Multi-line free text	Describe coat color and pattern, eye color, fur length and texture, and any distinctive physical traits.
Reference photo	No	Image upload	Upload a clear photo of the animal to provide a visual reference for the AI. Leave empty for natural generation.

Example values: Golden coat, fluffy tail, brown eyes, medium-length fur. · Black and white tuxedo pattern, short fur, green eyes.

---

Step 3: Details

Distinctive features like markings, scars, or accessories.

Field	Required	Type	Hint
Description	No	Multi-line free text	Add distinctive features like markings, patches, scars, or accessories such as a collar or bandana.

Example values: White patch on chest. Wearing a red leather collar. · Scar above left eye. Three white paw spots.

---

Animal Model - Step Summary

Step	Section title	Subtitle	Required fields	Optional fields
1	Identity	Basic information to identify and categorize the animal.	Model name, Model code, Species, Age	Breed, Sex
2	Appearance	Coat, coloring, eye color, and overall look.	Appearance description	Reference photo
3	Details	Distinctive features like markings, scars, or accessories.	—	Description

---

Custom Model - All Fields and Options

The Custom type provides complete freedom with no structured categories. Use it for any subject that doesn't fit Human or Animal (e.g., a mannequin, a robot, a fantasy character, or a stylized object).

Step 1: Identity

Basic information to identify the model.

Field	Required	Type	Notes
Model name	Yes	Free text	Display label (e.g., Wooden Mannequin, Retro Robot)
Model code	Yes	Free text (slug)	Unique system identifier (e.g., wooden_mannequin)

---

Step 2: Model description

A free-form description of your model.

Field	Required	Type	Hint
Description	Yes	Multi-line free text	Describe your model freely – appearance, species, style, or anything relevant.
Reference image	No	Image upload	Upload a reference image to guide the AI. Leave empty for natural generation.

Example values: A white plastic mannequin with no facial features, neutral pose, slim build. · An anthropomorphic fox character with orange fur, green eyes, wearing streetwear clothing.

---

Custom Model - Step Summary

Step	Section title	Subtitle	Required fields	Optional fields
1	Identity	Basic information to identify the model.	Model name, Model code	—
2	Model description	A free-form description of your model.	Description	Reference image

---

Visual Builder - When and How to Use It

The Visual builder is available for Human models in the Face, Hair, and Body steps. It is not available for Animal or Custom models.

Behavior	Detail
Activation	Click the "Visual builder" button next to the hint text "Select predefined styles instead of writing a manual description."
Output	Selecting options in the Visual builder auto-generates a text string in the description field (e.g., Type: Oval. Skin tone: Porcelain. Eye color: Blue.)
Switching modes	You can switch between Visual builder and free text at any time. The last-saved text is preserved in the description field.
Overriding	After using the Visual builder you can manually edit the generated text to add nuance the builder doesn't cover (e.g., hooded eyelids, deep-set eyes).

---

Reference Images - Usage Guide

Three sections accept reference image uploads:

Section	Field name	Purpose	Guidance
Human → Face	Face reference photo	Provides specific facial feature reference	Upload a clear, front-facing portrait. The AI uses it as a likeness anchor.
Animal → Appearance	Reference photo	Provides visual reference for the specific animal	Upload a clear photo of the