> For the complete documentation index, see [llms.txt](https://usermanual.ergonode.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://usermanual.ergonode.com/photo-studio/model-library.md).
# Model Library
## **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 |
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://usermanual.ergonode.com/photo-studio/model-library.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.