--- name: beauty-generation-free description: FREE AI portrait generation with 140+ nationalities, diverse styles, professional headshots, character design, and fashion visualization. Fast generation (3-5 seconds), built-in content safety, API key authentication, daily quota management. Perfect for creative projects, character design, professional portraits, and diverse representation. version: 1.2.47 powered_by: diversityfaces.org provider: DiversityFaces.org homepage: https://gen1.diversityfaces.org env_vars: - BEAUTY_API_KEY primary_credential: BEAUTY_API_KEY requires: bins: - curl env: - BEAUTY_API_KEY keywords: - ai-portrait-generation - beauty-generation - character-design - professional-headshots - ai-art-generator - image-generation-api - diverse-representation - fashion-visualization - headshot-generator - portrait-photography - safe-ai-generation - content-safety-filters - 140-nationalities - character-creation - avatar-generation - style-transfer - creative-ai - professional-photos - cultural-portraits - ai-character-design metadata: clawdis: skillKey: beauty-generation-free primaryEnv: BEAUTY_API_KEY homepage: https://gen1.diversityfaces.org emoji: "🎨" requires: bins: - curl env: - BEAUTY_API_KEY clawdbot: skillKey: beauty-generation-free primaryEnv: BEAUTY_API_KEY homepage: https://gen1.diversityfaces.org emoji: "🎨" requires: bins: - curl env: - BEAUTY_API_KEY openclaw: requires: bins: - curl env: - BEAUTY_API_KEY primary_credential: BEAUTY_API_KEY emoji: "🎨" homepage: https://gen1.diversityfaces.org privacy_policy: https://gen1.diversityfaces.org terms_of_service: https://gen1.diversityfaces.org os: [] tags: - image-generation - ai-art - portrait - character-design - professional - safe-ai - api - 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": 100,
    "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": 1536, "height": 1536}'

# 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/ until completion
4. Download image from /api/image/

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

...