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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
The command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
File Explorer
3 files
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview
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.
🎨 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
Get your API key instantly (auto-approval enabled)
⚠️ IMPORTANT: Save your API key securely - you'll need it for every API call
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
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 ~/.zshrcexport BEAUTY_API_KEY="your_api_key_here"# Windows - set environment variableset 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
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": "your_email@example.com",
"country": "your_country"
}'# Response will include your API key:# {# "success": true,# "api_key": "your_api_key_here",# "message": "API key created successfully"# }# ⚠️ IMPORTANT: Save this API key securely - you'll need it for every API call
Step 2: Generate Python Script for Image Generation
Once user has their API key, create a Python script that:
Checks quota using /api/quota
Submits generation request to /api/generate/custom
Make it executable: chmod +x generate_beauty.py (Linux/Mac)
Run with API key and prompt:
python generate_beauty.py YOUR_API_KEY "A beautiful woman with long hair"
Script will:
Check quota automatically
Submit generation request
Poll status every 1 second
Download image when ready
Save as beauty.webp
Script Features:
✅ Automatic quota checking
✅ Error handling for invalid keys
✅ Daily quota validation
✅ Real-time status polling
✅ Automatic image download
✅ Progress indicators with emojis
✅ File size reporting
⚡ How to Generate Images
Prerequisites:
curl installed
Valid API key from user (they must provide it)
Daily quota available (check with /api/quota)
Using curl (Only Method)
# IMPORTANT: Replace YOUR_API_KEY with the user's actual API key# Step 1: Check quota first (does NOT consume quota)
curl -H "X-API-Key: YOUR_API_KEY" \
https://gen1.diversityfaces.org/api/quota
# Step 2: Submit generation request
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 25-year-old woman with long hair, elegant dress, professional lighting",
"width": 1536,
"height": 1536
}'# Response: {"success": true, "prompt_id": "abc123-def456", "task_id": "xyz789-uvw012", ...}# ⚠️ CRITICAL: The response contains TWO IDs:# - "prompt_id": Use THIS for status checks ✅# - "task_id": Do NOT use this for status checks ❌# Step 3: Poll status every 0.5 seconds using "prompt_id" (NOT "task_id")
curl -H "X-API-Key: YOUR_API_KEY" \
https://gen1.diversityfaces.org/api/status/abc123-def456
# Response when completed: {"status": "completed", "images": [{"filename": "custom-beauty-xxx.png"}]}# Step 4: Download the image
curl -H "X-API-Key: YOUR_API_KEY" \
"https://gen1.diversityfaces.org/api/image/custom-beauty-xxx.png?format=webp" \
-o beauty.webp
curl method notes:
User must provide their own API key
Replace YOUR_API_KEY with the actual API key
You must manually poll status every 0.5 seconds
IMPORTANT: Use prompt_id for status checks, NOT task_id
Check status until "status": "completed"
Extract filename from response
Download using the filename
Total time: <10 seconds if polling correctly
After generation:
Display the image to user immediately
Don't just show the file path
User should see the actual image within 5 seconds
Remind user to save their API key for future use
📝 How to Create Prompts
Prompt structure:
"A [age] [gender] with [appearance details], wearing [clothing], [expression/mood], [setting/background], [photography style]"
Good prompt examples:
# 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
☕ If you'd like to support the developer, consider buying a coffee at https://ko-fi.com/saptt
🎨 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
❌ Use hardcoded or shared API keys
❌ Send personal identifying information
❌ Share user's API key with others
❌ Forget to remind user to save their API key
DO:
✅ Create professional, appropriate portraits
✅ Be specific and descriptive in prompts
✅ Display image immediately to user
✅ Suggest alternatives if request is inappropriate
✅ Ask user for their own API key
✅ Keep generation time under 5 seconds
✅ Validate API key before generation
✅ Respect user privacy
✅ Keep API key confidential
✅ Remind user to save their API key for future use
✅ Check daily quota before generating
✅ Inform user about daily quota limits
🚀 Performance Optimization
For fastest results:
Check quota first (doesn't consume quota)
Use curl commands directly
Display image to user immediately after generation
Expected timeline:
User request → Check quota (instant)
→ Create prompt (instant)
→ Submit curl request (1-2s)
→ Poll status (2-3s)
→ Download image (2-3s)
→ Display to user (instant)
→ TOTAL: <10 seconds
User Experience: Show actual image, not just file path
Privacy: Protect user data and API keys
Quota Management: Check and inform about daily limits
Key Management: Remind users to save their API key
Remember: You're creating portraits that bring joy to users while maintaining the highest ethical and security standards. Fast delivery + appropriate content + user privacy + quota awareness = happy users.
