beauty-generation-free

🎨 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:

# 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:

{
  "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:

# 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:

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

# 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

# Create a config file (e.g., ~/.beauty_config or .env)
BEAUTY_API_KEY=your_api_key_here

Option 3: Pass as Command-Line Argument

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: 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
• ❌ Personal identifying information

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 Help Users Get API Keys

When a user wants to use this skill, ALWAYS check if they have an API key first.

Step 1: Request API Key Using curl

If user doesn't have an API key, show them how to request one using curl:

# Visit the API key request page in browser:
# https://gen1.diversityfaces.org/api-key-request

# Or use curl to submit the request:
curl -X POST https://gen1.diversityfaces.org/api-key-request \
  -H "Content-Type: application/json" \
  -d '{
    "username": "your_username",
    "email": "[email protected]",
    "country": "your_country"
  }'

# Response

---

*Content truncated.*