Characters
The Characters view lets you create and manage your character library for consistent multi-scene image generation.
Overview
The Characters feature enables:
- Consistent characters across unlimited scenes
- Reference image storage for visual consistency
- Character library organization with tags
- Usage tracking to see popular characters
Character Library
Library View
┌─────────────────────────────────────────────────────────────┐
│ Characters [🔍 Search] [+ New Character] │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │
│ │ Luna │ │ Captain Rex │ │ Felix │ │
│ │ 45 uses │ │ 23 uses │ │ 18 uses │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
│ ┌─────────────┐ ┌─────────────┐ ┌─────────────┐ │
│ │ 🖼️ │ │ 🖼️ │ │ + │ │
│ │ Maya │ │ Bolt │ │ Add New │ │
│ │ 12 uses │ │ 8 uses │ │ │ │
│ └─────────────┘ └─────────────┘ └─────────────┘ │
│ │
└─────────────────────────────────────────────────────────────┘Sorting Options
| Sort | Description |
|---|---|
| Most Used | By times_used (default) |
| Name A-Z | Alphabetical |
| Newest | Recently created |
| Recently Used | Last used date |
Filtering
Filter by tags:
┌─────────────────────────────────────────────────────┐
│ Tags: [All] [Fantasy] [Sci-Fi] [Animals] [People] │
└─────────────────────────────────────────────────────┘Creating a Character
Step 1: Basic Information
┌─────────────────────────────────────────────────────┐
│ Create Character [×] │
├─────────────────────────────────────────────────────┤
│ Character Name * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Luna │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Description (optional) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Young adventurer protagonist for fantasy series │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Tags (optional) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ fantasy, protagonist, adventurer │ │
│ └─────────────────────────────────────────────────┘ │
└─────────────────────────────────────────────────────┘Step 2: Character Appearance
┌─────────────────────────────────────────────────────┐
│ Base Prompt * │
│ ┌─────────────────────────────────────────────────┐ │
│ │ A young woman with bright red hair in a long │ │
│ │ braid, emerald green eyes, freckles across her │ │
│ │ nose, wearing a brown leather adventurer's │ │
│ │ outfit with gold trim and a green cloak │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ 💡 Be specific about distinctive features that │
│ should remain consistent across scenes │
└─────────────────────────────────────────────────────┘Step 3: Style Settings (Optional)
┌─────────────────────────────────────────────────────┐
│ System Instruction (optional) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Create in fantasy illustration style with soft │ │
│ │ lighting and rich colors │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Negative Prompt (optional) │
│ ┌─────────────────────────────────────────────────┐ │
│ │ realistic photo, 3D render, anime │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Preferred Aspect Ratio │
│ [□ Square] [▬ Landscape] [● Portrait] │
└─────────────────────────────────────────────────────┘Step 4: Reference Images
┌─────────────────────────────────────────────────────┐
│ Reference Images │
├─────────────────────────────────────────────────────┤
│ Add images that show your character's appearance │
│ │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 🖼️ 1 │ │ 🖼️ 2 │ │ 🖼️ 3 │ │ + │ │
│ │ [×] │ │ [×] │ │ [×] │ │ Add │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ Select from Gallery or upload new images │
│ │
│ [Select from Gallery] [Upload New] │
└─────────────────────────────────────────────────────┘Step 5: Preview and Save
┌─────────────────────────────────────────────────────┐
│ Preview │
├─────────────────────────────────────────────────────┤
│ Character: Luna │
│ │
│ When you use this character, the prompt will be: │
│ ┌─────────────────────────────────────────────────┐ │
│ │ "The character in Image 1 — keep face, hair, outfit EXACTLY the same │ │
│ │ [your scene description]" │ │
│ │ │ │
│ │ Reference images will be included automatically │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [← Back] [Create Character] │
└─────────────────────────────────────────────────────┘Character Detail View
Click a character to see full details:
┌─────────────────────────────────────────────────────────────┐
│ Luna [Edit] [Delete] │
├─────────────────────────────────────────────────────────────┤
│ │
│ ┌───────────────┐ Character Details │
│ │ │ ───────────────── │
│ │ 🖼️ Ref 1 │ Name: Luna │
│ │ │ Created: Jan 10, 2024 │
│ └───────────────┘ Times Used: 45 │
│ ┌───────────────┐ Last Used: Jan 15, 2024 │
│ │ │ │
│ │ 🖼️ Ref 2 │ Tags: fantasy, protagonist, adventurer │
│ │ │ │
│ └───────────────┘ │
│ │
│ Base Prompt: │
│ ┌─────────────────────────────────────────────────────┐ │
│ │ A young woman with bright red hair in a long braid, │ │
│ │ emerald green eyes, freckles across her nose... │ │
│ └─────────────────────────────────────────────────────┘ │
│ │
│ Recent Images with Luna │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │ 🖼️ │ │
│ └─────────┘ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ [Generate with Luna] │
└─────────────────────────────────────────────────────────────┘Editing Characters
Update Basic Info
┌─────────────────────────────────────────────────────┐
│ Edit Character: Luna [×] │
├─────────────────────────────────────────────────────┤
│ Character Name │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Luna │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ Description │
│ ┌─────────────────────────────────────────────────┐ │
│ │ Updated description here... │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [Cancel] [Save Changes] │
└─────────────────────────────────────────────────────┘Update Reference Images
Add or remove reference images:
┌─────────────────────────────────────────────────────┐
│ Reference Images │
├─────────────────────────────────────────────────────┤
│ Current (2 images) │
│ ┌─────────┐ ┌─────────┐ │
│ │ 🖼️ │ │ 🖼️ │ │
│ │ [×] │ │ [×] │ │
│ └─────────┘ └─────────┘ │
│ │
│ [+ Add More] │
│ │
│ 💡 Tip: Use 2-3 reference images showing │
│ different angles for best consistency │
└─────────────────────────────────────────────────────┘Using Characters
From Characters View
- Click character card
- Click Generate with Luna
- Enter scene description
- Generate
From Composer
- Go to Composer → Character tab
- Select character from dropdown
- Enter scene description
- Generate
Quick Generate
Right-click character for quick actions:
┌─────────────────────────────┐
│ Generate New Scene │
│ View All Images │
│ ─────────────────────────── │
│ Edit Character │
│ Duplicate Character │
│ ─────────────────────────── │
│ Delete Character │
└─────────────────────────────┘Multi-Character Scenes
Generate images with 2-5 characters together:
┌─────────────────────────────────────────────────────┐
│ Multi-Character Scene │
├─────────────────────────────────────────────────────┤
│ Selected Characters: │
│ ┌─────────┐ ┌─────────┐ ┌─────────┐ │
│ │ Luna │ │ Felix │ │ + │ │
│ │ [×] │ │ [×] │ │ Add │ │
│ └─────────┘ └─────────┘ └─────────┘ │
│ │
│ Scene Description: │
│ ┌─────────────────────────────────────────────────┐ │
│ │ having a picnic in a sunny meadow together │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [Generate Scene] │
└─────────────────────────────────────────────────────┘Best Practices
Effective Base Prompts
Do include:
- Distinctive physical features
- Consistent clothing/accessories
- Art style preferences
- Color details
Avoid:
- Scene-specific actions
- Backgrounds or settings
- Temporal descriptions
✅ Good: "A young woman with bright red hair in a
long braid, emerald green eyes, freckles, wearing
brown leather adventurer's outfit with gold trim"
❌ Bad: "A young woman running through a forest
at sunset looking scared"Reference Image Tips
- Multiple angles: Front, side, 3/4 view
- Consistent style: Keep art style uniform
- Clear features: Show distinctive traits
- 2-3 images: More isn't always better
Character Organization
Use tags for easy filtering:
| Tag Type | Examples |
|---|---|
| Genre | fantasy, sci-fi, modern |
| Role | protagonist, villain, sidekick |
| Species | human, animal, robot |
| Project | book-cover, game-art, marketing |
Deleting Characters
WARNING
Deleting a character removes it permanently. Images generated with the character are NOT deleted.
┌─────────────────────────────────────────────────────┐
│ Delete Character? │
├─────────────────────────────────────────────────────┤
│ Are you sure you want to delete "Luna"? │
│ │
│ • Character definition will be removed │
│ • Reference images will be deleted │
│ • 45 generated images will NOT be affected │
│ │
│ [Cancel] [Delete] │
└─────────────────────────────────────────────────────┘Import/Export
Export Character
Save character definition for backup:
┌─────────────────────────────────────────────────────┐
│ Export Character │
├─────────────────────────────────────────────────────┤
│ ☑ Include character definition │
│ ☑ Include reference images │
│ ☐ Include generated images │
│ │
│ [Export as ZIP] │
└─────────────────────────────────────────────────────┘Import Character
Restore from backup:
┌─────────────────────────────────────────────────────┐
│ Import Character │
├─────────────────────────────────────────────────────┤
│ Drop ZIP file here or click to browse │
│ │
│ ┌─────────────────────────────────────────────────┐ │
│ │ 📁 │ │
│ │ Drop file here │ │
│ └─────────────────────────────────────────────────┘ │
│ │
│ [Browse Files] │
└─────────────────────────────────────────────────────┘API Access
Characters are also accessible via:
- MCP Tools:
create_character,list_characters,generate_with_character - REST API:
GET/POST /api/characters
See Characters API → for details.