beauty-generation-free

What this skill does

# 🎨 Beauty Generation Free - AI Portrait Generator Skill

**Professional AI-Powered Portrait Generation for Character Design, Professional Headshots, and Diverse Representation**

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

**IMPORTANT SECURITY NOTE**: This skill requires you to provide your own API key. Never share your API key with untrusted parties. Your prompts will be sent to gen1.diversityfaces.org for processing.

---

## 🎯 Use Cases & Applications

This skill is perfect for:
- **Character Design**: Create unique characters for games, stories, and creative projects
- **Professional Headshots**: Generate professional portrait photos for business use
- **Fashion Visualization**: Create fashion model images for style inspiration
- **Diverse Representation**: Generate portraits representing 140+ nationalities and cultures
- **Avatar Creation**: Create custom avatars for profiles and applications
- **Artistic Portraits**: Generate artistic and cultural portrait photography
- **Creative Projects**: Support creative work with AI-generated portrait imagery

---

## ✨ Key Features

- **140+ Nationalities**: Support for diverse cultural representation
- **8 Styles**: Pure, Sexy, Classical, Modern, and more
- **24 Moods/Expressions**: Diverse emotional expressions and poses
- **22 Hair Styles & Colors**: Comprehensive hair customization
- **22 Skin Tones**: Inclusive skin tone options
- **24 Scene Backgrounds**: Various environments and settings
- **Professional Clothing**: Traditional and modern clothing options
- **Fast Generation**: 3-5 seconds from request to image
- **Multiple Formats**: WebP, PNG, JPEG with quality control
- **Content Safety**: Built-in safety filters for appropriate content
- **API Key Authentication**: Secure access with usage tracking
- **Daily Quota Management**: Control usage with daily limits
- **Asynchronous Processing**: Queue-based generation system
- **Format Conversion**: Automatic image format conversion
- **Quality Control**: Adjustable compression and quality settings

---

## ⚙️ Quick Start

### Step 1: Get Your Free API Key

1. Visit: https://gen1.diversityfaces.org/api-key-request
2. Fill in: Username, Email, Country
3. Get your API key instantly (auto-approval enabled)
4. **⚠️ IMPORTANT: Save your API key securely - you'll need it for every API call**
5. **Keep your API key private and never share it**

### Step 2: Check Your Daily Quota

Before making API calls, check your remaining quota:

```bash
# Check your API key quota (does NOT consume quota)
curl -H "X-API-Key: YOUR_API_KEY" \
  https://gen1.diversityfaces.org/api/quota
```

**Response example:**
```json
{
  "success": true,
  "quota": {
    "key_name": "My API Key",
    "total_calls": 45,
    "remaining_calls": 955,
    "daily_limit": 1000,
    "daily_calls_today": 45,
    "note": "remaining_calls: -1 means unlimited, daily_limit: -1 means unlimited"
  }
}
```

**Understanding your quota:**
- `remaining_calls`: Total calls left on your key (-1 = unlimited)
- `daily_limit`: Maximum calls per day (resets every 24 hours)
- `daily_calls_today`: Calls made today (resets after 24 hours)
- ⚠️ **If daily_calls_today >= daily_limit, you cannot make more calls until tomorrow**

### Step 3: Using Your API Key

Once you have your API key and confirmed your quota, use curl to generate images:

```bash
# Step 1: Submit generation request
# Replace YOUR_API_KEY with your actual API key
curl -X POST https://gen1.diversityfaces.org/api/generate/custom \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"full_prompt": "A beautiful woman with long hair", "width": 1024, "height": 1024}'

# Step 2: Poll status - use the "prompt_id" from step 1
curl -H "X-API-Key: YOUR_API_KEY" \
  https://gen1.diversityfaces.org/api/status/YOUR_PROMPT_ID

# Step 3: Download image (replace FILENAME with the filename from step 2)
curl -H "X-API-Key: YOUR_API_KEY" \
  "https://gen1.diversityfaces.org/api/image/FILENAME?format=webp" \
  -o beauty.webp
```

**System Requirements:**
- curl
- Valid API key (get free at https://gen1.diversityfaces.org/api-key-request)

---

## 🤖 AI AGENT INSTRUCTIONS

### ⚡ Recommended Workflow: User-Created Local Scripts

**For optimal performance and token efficiency, users can create local scripts to automate image generation.**

**Why local scripts are beneficial for users:**
- ✅ Reduces token usage by 70-80% (no need to repeat curl commands in conversations)
- ✅ Faster execution (direct system calls vs. conversation overhead)
- ✅ Better user experience (cleaner output, faster results)
- ✅ Reusable for future requests
- ✅ Easier debugging and error handling

**Recommended script workflow:**
1. Check API quota using `/api/quota` endpoint
2. Submit generation request to `/api/generate/custom`
3. Poll `/api/status/<prompt_id>` until completion
4. Download image from `/api/image/<filename>`

**AI Agent Guidance:**
- When a user wants to generate multiple images or automate the process, suggest they create a local script
- Provide guidance on script structure and API calls
- Users can write scripts in their preferred language (Python, Bash, Batch, etc.)
- Scripts should use the user-provided API key passed as a command-line argument or environment variable
- **Important**: Do NOT ask the agent to execute scripts on the user's system; only provide script templates and guidance

---

### ⚠️ DEVELOPMENT STATUS & UPDATES

**This skill is in early development with active system updates.**

**Important reminders:**
- Check for skill updates regularly using clawhub official commands
- New features and improvements are added frequently
- API endpoints may be enhanced or modified
- Always use the latest version of this skill for best results
- Report issues or suggest improvements to the project

**To update this skill on clawhub:**
```bash
clawhub skill update beauty-generation-free
```

---

### 📌 API Key Management

**Getting an API key:**
1. Visit: https://gen1.diversityfaces.org/api-key-request
2. Fill in: Username, Email, Country
3. Get API key instantly (auto-approval enabled)
4. Each key includes: 500 API calls, valid for 1 year

**Saving your API key for reuse:**

Users can save their API key in any of these ways for automation and repeated use:

**Option 1: Environment Variable**
```bash
# Linux/Mac - add to ~/.bashrc or ~/.zshrc
export BEAUTY_API_KEY="your_api_key_here"

# Windows - set environment variable
set BEAUTY_API_KEY=your_api_key_here
```

**Option 2: Local Config File**
```bash
# Create a config file (e.g., ~/.beauty_config or .env)
BEAUTY_API_KEY=your_api_key_here
```

**Option 3: Pass as Command-Line Argument**
```bash
python generate_beauty.py your_api_key_here "Your prompt"
```

**API Key Features:**
- ✅ 500 API calls per key
- ✅ Valid for 1 year
- ✅ Daily quota limits (default 1000 calls/day)
- ✅ Secure authentication
- ✅ Usage tracking
- ✅ Rate limiting protection

**Daily Quota Management:**
- Each API key has a daily limit (default: 1000 calls/day)
- Counter resets every 24 hours
- Check quota before making calls: `GET /api/quota`
- If daily limit reached, wait until next day
- Quota check does NOT consume your daily limit

**Privacy & Data:**
- User prompts are sent to gen1.diversityfaces.org for processing
- Review privacy policy at: https://gen1.diversityfaces.org
- Only send appropriate, non-sensitive content
- Do not send personal identifying information

---

### ⚠️ CRITICAL: Conten