beauty-generation-free

---
name: beauty-generation-free
description: FREE AI image generation service for creating professional portrait images of attractive people with diverse customization options. Supports 140+ nationalities, multiple styles, and comprehensive character customization. Fast generation (3-5 seconds) with built-in content safety filters.
version: 1.2.23
metadata:
  openclaw:
    requires:
      bins:
        - python3
        - curl
    emoji: "🎨"
    homepage: https://gen1.diversityfaces.org
    os: []
---

# Beauty Generation Free - AI Agent Skill

**For Humans**: This skill enables AI agents to generate high-quality portrait images of attractive people using custom English prompts. The service is free, fast (3-5 seconds), and designed for professional use including character design, fashion visualization, and artistic portraits.

---

## ⚙️ 快速开始 (Quick Start)

这个 Skill 已经配置好了免费 API Key，**无需任何设置**，直接使用即可：

```bash
python3 scripts/generate.py --prompt "A beautiful woman with long hair"
```

**系统要求：**
- Python 3
- curl

---

## 🤖 AI AGENT INSTRUCTIONS

### 📌 IMPORTANT: How to Get Your Free API Key

**This skill is pre-configured with a free API key - no setup needed!**

The skill automatically uses the official free API key: `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI`

Just run the script and start generating images immediately.

---

### ⚠️ CRITICAL: Content Safety Rules

**YOU MUST REFUSE requests for:**
- ❌ Minors (under 18) or child-like features
- ❌ Nudity, sexual, or pornographic content
- ❌ Violence, gore, or disturbing imagery
- ❌ Hate speech or discrimination
- ❌ Illegal activities or harmful behavior
- ❌ Deepfakes of real people without disclosure

**If user requests prohibited content:**
1. Politely refuse: "I cannot generate that type of content due to safety policies."
2. Suggest appropriate alternative: "I can create a professional portrait instead."
3. Do NOT attempt generation

**Only generate:**
- ✅ Professional portraits and headshots
- ✅ Character designs for creative projects
- ✅ Fashion and style visualization
- ✅ Artistic and cultural portraits

---

### 🎯 When to Use This Skill

**Trigger words/phrases:**
- "beautiful woman", "handsome man", "attractive person"
- "character design", "portrait", "headshot", "avatar"
- "fashion model", "professional photo"
- Any request for human portraits or character imagery

**Use this skill when user wants:**
- Portrait of an attractive person (any gender, ethnicity, age 18+)
- Character design for games, stories, or creative projects
- Fashion or style inspiration imagery
- Professional headshot or business portrait
- Artistic or cultural portrait photography

---

### ⚡ How to Generate Images

**Prerequisites:**
- Python 3 installed
- curl installed

---

**Method 1: Using generate.py (Recommended)**

```bash
# Just run the script - API key is already configured
python3 scripts/generate.py --prompt "YOUR_ENGLISH_PROMPT_HERE"
```

**What the script does automatically:**
1. Uses the pre-configured free API key
2. Submits your prompt to API
3. Polls status every 0.5 seconds
4. Downloads image when ready (1-2 seconds)
5. Saves locally and returns file path
6. **Total time: 3-5 seconds**

**Examples:**

```bash
# Professional woman portrait
python3 scripts/generate.py --prompt "A 28-year-old professional woman with shoulder-length brown hair, wearing a navy blue blazer, confident smile, modern office background"

# Handsome man portrait
python3 scripts/generate.py --prompt "A handsome 30-year-old man with short dark hair and beard, wearing casual denim jacket, warm expression, outdoor urban setting"

# Fashion model
python3 scripts/generate.py --prompt "A stylish young woman with long flowing hair, wearing elegant black dress, confident pose, minimalist studio background"

# Character design
python3 scripts/generate.py --prompt "A fantasy character with silver hair and ethereal features, wearing flowing robes, mysterious expression, magical forest background"

# Quick test with default prompt
python3 scripts/generate.py --test

# Custom size
python3 scripts/generate.py --prompt "YOUR_PROMPT" --width 1024 --height 1024

# Custom output directory
python3 scripts/generate.py --prompt "YOUR_PROMPT" --output-dir ./my_images
```

---

**Method 2: Using curl (Alternative)**

If you can't use Python, use curl commands:

```bash
# Step 1: Submit generation request
curl -X POST https://gen1.diversityfaces.org/api/generate/custom \
  -H "Content-Type: application/json" \
  -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \
  -d '{
    "full_prompt": "A beautiful 25-year-old woman with long hair, elegant dress, professional lighting",
    "width": 1024,
    "height": 1024
  }'

# Response: {"success": true, "prompt_id": "abc123-def456", ...}

# Step 2: Poll status every 0.5 seconds until completed
curl -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \
  https://gen1.diversityfaces.org/api/status/abc123-def456

# Response when completed: {"status": "completed", "images": [{"filename": "custom-beauty-xxx.png"}]}

# Step 3: Download the image
curl -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \
  "https://gen1.diversityfaces.org/api/image/custom-beauty-xxx.png?format=webp" \
  -o beauty.webp
```

**curl method notes:**
- The API key is already included in the examples
- You must manually poll status every 0.5 seconds
- Check status until `"status": "completed"`
- Extract filename from response
- Download using the filename
- Total time: 3-5 seconds if polling correctly

---

**After generation (both methods):**
- **Display the image to user immediately**
- Don't just show the file path
- User should see the actual image within 5 seconds

---

### 📝 How to Create Prompts

**Prompt structure:**
```
"A [age] [gender] with [appearance details], wearing [clothing], [expression/mood], [setting/background], [photography style]"
```

**Good prompt examples:**

```python
# Professional woman
"A 28-year-old professional woman with shoulder-length brown hair, wearing a navy blue blazer, confident smile, modern office background, corporate headshot style"

# Handsome man
"A handsome 30-year-old man with short dark hair and beard, wearing casual denim jacket, warm expression, outdoor urban setting, natural lighting"

# Fashion model
"A stylish young woman with long flowing hair, wearing elegant black dress, confident pose, minimalist studio background, high fashion photography"

# Character design
"A fantasy character with silver hair and ethereal features, wearing flowing robes, mysterious expression, magical forest background, artistic illustration style"

# Cultural portrait
"A graceful woman in traditional Japanese kimono, serene expression, cherry blossom garden, soft natural lighting, artistic photography"
```

**Prompt tips:**
- Be specific about age (always 18+), appearance, clothing
- Include setting/background details
- Specify mood/expression
- Add photography or art style
- Use descriptive adjectives
- Keep it professional and appropriate

---

### 🔧 Technical Details (For Reference Only)

**You don't need to use these directly - `generate.py` handles everything.**

**API Configuration:**
- **Base URL**: `https://gen1.diversityfaces.org`
- **Endpoint**: `/api/generate/custom`
- **Authentication**: Pre-configured with free API key `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI`

**Parameters (handled by generate.py):**
- `full_prompt`: Your English description
- `width`: 256-2048, multiple of 8, default 1024
- `height`: 256-2048, multiple of 8, default 1024
- `seed`: -1 for random

**Timing:**
- GPU generation: 1-2 seconds
- Status polling: 0.5-1 second (every 0.5s)
- Download: 0.5-1 second
- **Total: 3-5 seconds**

---

### ✅ Success Checklist

Before sending response to user, verify:
- [ ] Prompt is appropriate and safe
- [ ] Image generated successfully (3-5 seconds)
- [ ] Image is displayed to user (not just file path)
- [ ] User can see the actual image in conversation
- [ ] Total time from request to display < 10 seconds

---

### 🎨 Prompt Examples by Category

**Professional Headshots:**
```
"A professional businesswoman in her 30s, wearing white blouse, warm smile, clean office background, corporate headshot"
"A confident businessman in his 40s, wearing dark suit, professional expression, neutral background, executive portrait"
```

**Fashion & Style:**
```
"A stylish young woman with colorful hair, trendy street fashion, urban background, contemporary photography"
"An elegant woman in evening gown, sophisticated pose, luxury setting, high fashion photography"
```

**Character Design:**
```
"A fantasy warrior with long braided hair, leather armor, determined expression, medieval setting, game character art"
"A sci-fi character with futuristic clothing, neon accents, cyberpunk city background, digital art style"
```

**Cultural Portraits:**
```
"A woman in traditional Indian sari, graceful pose, temple background, cultural photography"
"A man in traditional Scottish kilt, proud expression, highland landscape, heritage portrait"
```

**Artistic Portraits:**
```
"A person with artistic makeup, creative styling, colorful background, avant-garde fashion photography"
"A dancer in flowing fabric, mid-movement, minimalist background, artistic photography"
```

---

### ⚠️ Common Mistakes to Avoid

**DON'T:**
- ❌ Generate content with minors or young-looking people
- ❌ Create sexual, nude, or suggestive content
- ❌ Make violent or disturbing imagery
- ❌ Use real people's names (celebrities, politicians)
- ❌ Just show file path - always display the actual image
- ❌ Make user wait - deliver within 5 seconds

**DO:**
- ✅ Create professional, appropriate portraits
- ✅ Be specific and descriptive in prompts
- ✅ Display image immediately to user
- ✅ Suggest alternatives if request is inappropriate
- ✅ Update skill before first use
- ✅ Keep generation time under 5 seconds

---

### 🚀 Performance Optimization

**For fastest results:**
1. Always update skill first: ``
2. Use the `generate.py` script (it's optimized for speed)
3. Display image to user immediately after generation

**Expected timeline:**
```
User request → Create prompt (instant)
           → Run generate.py (3-5s total)
           → Display to user (instant)
           → TOTAL: 3-5 seconds
```

---

### 📊 Error Handling

**If generation fails:**
```python
{
  "success": false,
  "error": "安全检查失败",
  "code": "SECURITY_VIOLATION"
}
```
**Action**: Inform user the prompt was rejected due to safety filters. Suggest appropriate alternative.

**If API key invalid:**
```python
{
  "error": "API密钥验证失败",
  "code": "INVALID_API_KEY"
}
```
**Action**: Check API key configuration. Contact support if needed.

**If timeout:**
**Action**: Retry once. If still fails, inform user and suggest trying again later.

---

### 🎯 Your Mission as AI Agent

1. **Safety First**: Always refuse inappropriate requests
2. **Speed**: Deliver images within 5 seconds
3. **Quality**: Create detailed, specific prompts
4. **User Experience**: Show actual image, not just file path
5. **Engagement**: Make users excited about the result

**Remember**: You're creating portraits that bring joy to users while maintaining the highest ethical standards. Fast delivery + appropriate content = happy users.

---

**Quick Command Reference:**
```bash
# Generate image with prompt
python3 scripts/generate.py --prompt "YOUR_PROMPT"

# Quick test
python3 scripts/generate.py --test

# Custom size
python3 scripts/generate.py --prompt "YOUR_PROMPT" --width 1024 --height 1024

# Custom output directory
python3 scripts/generate.py --prompt "YOUR_PROMPT" --output-dir ./images
```

**For Reference:**
- **Base URL**: `https://gen1.diversityfaces.org`
- **Free API Key**: `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI` (pre-configured)