beauty-generation-api
by @luruibu
AI portrait image generation with 140+ nationalities, diverse styles, professional headshots, character design, and fashion visualization. Fast generation (3...
clawhub install beauty-generation-apiπ About This Skill
name: beauty-generation-api description: AI portrait image 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.A donation of $5 entitles you to an API key with a credit of 1,000 images. version: 1.2.50 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-api primaryEnv: BEAUTY_API_KEY homepage: https://gen1.diversityfaces.org emoji: "π¨" requires: bins: - curl env: - BEAUTY_API_KEY clawdbot: skillKey: beauty-generation-api 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 - Api
π¨ Beauty Generation Api - AI Portrait image Generator Skill
A donation of $5 entitles you to an API key with a credit of 1,000 images. Professional AI-Powered Portrait Generation for Character Design, Professional Headshots, and Diverse RepresentationFor 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:
β¨ Key Features
βοΈ Quick Start
Step 1: Get Your 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)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_IDStep 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:
π€ 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:
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:
β οΈ DEVELOPMENT STATUS & UPDATES
This skill is in early development with active system updates.
Important reminders:
To update this skill on clawhub:
clawhub skill update beauty-generation-api
π 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: 1000 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:
Daily Quota Management:
GET /api/quotaPrivacy & Data:
β οΈ CRITICAL: Content Safety Rules
YOU MUST REFUSE requests for:
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:
π― When to Use This Skill
Trigger words/phrases:
Use this skill when user wants:
π 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:
1. Checks quota using /api/quota
2. Submits generation request to /api/generate/custom
3. Polls /api/status/ until completion
4. Downloads the generated image
Script template for user:
#!/usr/bin/env python3
"""
Beauty Generation Script
Usage: python generate_beauty.py YOUR_API_KEY "Your prompt here"
"""import sys
import json
import time
import requests
from pathlib import Path
def main():
if len(sys.argv) < 3:
print("Usage: python generate_beauty.py YOUR_API_KEY \"Your prompt\"")
print("Example: python generate_beauty.py abc123xyz \"A beautiful woman with long hair\"")
sys.exit(1)
api_key = sys.argv[1]
prompt = sys.argv[2]
base_url = "https://gen1.diversityfaces.org"
headers = {
"X-API-Key": api_key,
"Content-Type": "application/json"
}
try:
# Step 1: Check quota
print("π Checking quota...")
quota_resp = requests.get(f"{base_url}/api/quota", headers=headers)
quota_data = quota_resp.json()
if not quota_data.get('success'):
print(f"β Error: {quota_data.get('error', 'Unknown error')}")
return 1
quota = quota_data['quota']
print(f"β
Remaining calls: {quota['remaining_calls']}")
print(f"π
Daily limit: {quota['daily_limit']}")
print(f"π Today's calls: {quota['daily_calls_today']}")
# Check if daily quota exceeded
if quota['daily_limit'] != -1 and quota['daily_calls_today'] >= quota['daily_limit']:
print("β Daily quota exhausted! Please try again tomorrow.")
return 1
# Step 2: Submit generation request
print(f"\nπ¨ Submitting generation request...")
print(f"π Prompt: {prompt}")
gen_resp = requests.post(
f"{base_url}/api/generate/custom",
headers=headers,
json={
"full_prompt": prompt,
"width": 1536,
"height": 1536
}
)
gen_data = gen_resp.json()
if not gen_data.get('success'):
print(f"β Error: {gen_data.get('error', 'Unknown error')}")
return 1
prompt_id = gen_data['prompt_id']
print(f"β
Prompt ID: {prompt_id}")
# Step 3: Poll status
print(f"\nβ³ Polling status...")
max_attempts = 30
for attempt in range(max_attempts):
time.sleep(1)
status_resp = requests.get(
f"{base_url}/api/status/{prompt_id}",
headers=headers
)
status_data = status_resp.json()
if status_data['status'] == 'completed':
filename = status_data['images'][0]['filename']
print(f"β
Generation completed!")
print(f"π Filename: {filename}")
# Step 4: Download image
print(f"\nπ₯ Downloading image...")
img_resp = requests.get(
f"{base_url}/api/image/{filename}?format=webp",
headers=headers
)
output_file = "beauty.webp"
with open(output_file, "wb") as f:
f.write(img_resp.content)
print(f"β
Image saved as {output_file}")
print(f"File size: {Path(output_file).stat().st_size / 1536:.1f} KB")
return 0
elif status_data['status'] == 'processing':
print(f"β³ Processing... ({attempt + 1}/{max_attempts})")
elif status_data['status'] == 'pending':
print(f"β³ Pending... ({attempt + 1}/{max_attempts})")
print(f"β Timeout: Generation took too long")
return 1
except requests.exceptions.RequestException as e:
print(f"β Network error: {e}")
return 1
except Exception as e:
print(f"β Error: {e}")
return 1
if __name__ == "__main__":
sys.exit(main())
How to use the script:
1. Save the script as generate_beauty.py
2. Make it executable: chmod +x generate_beauty.py (Linux/Mac)
3. Run with API key and prompt:
python generate_beauty.py YOUR_API_KEY "A beautiful woman with long hair"
4. Script will:
- Check quota automatically
- Submit generation request
- Poll status every 1 second
- Download image when ready
- Save as beauty.webpScript Features:
β‘ How to Generate Images
Prerequisites:
/api/quota)Using curl (Only Method)
# IMPORTANT: Replace YOUR_API_KEY with the user's actual API keyStep 1: Check quota first (does NOT consume quota)
curl -H "X-API-Key: YOUR_API_KEY" \
https://gen1.diversityfaces.org/api/quotaStep 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-def456Response 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:
prompt_id for status checks, NOT task_id"status": "completed"After generation:
π 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:
π§ Technical Details (For Reference Only)
API Configuration:
https://gen1.diversityfaces.org/api/generate/customAvailable Endpoints:
POST /api/generate/custom - Generate image with custom promptGET /api/status/ - Check generation statusGET /api/image/ - Download generated imageGET /api/quota - Check API key quota (does NOT consume quota)Parameters:
full_prompt: Your English descriptionwidth: 256-2048, multiple of 8, default 1536height: 256-2048, multiple of 8, default 1536seed: -1 for randomTiming:
β Success Checklist
Before sending response to user, verify:
/api/quota)After successful generation:
π¨ 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:
DO:
π Performance Optimization
For fastest results: 1. Check quota first (doesn't consume quota) 2. Use curl commands directly 3. 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
οΏ½ Error Handling
If generation fails:
{
"success": false,
"error": "SECURITY_VIOLATION",
"code": "SECURITY_VIOLATION"
}
Action: Inform user the prompt was rejected due to safety filters. Suggest appropriate alternative.If API key invalid:
{
"error": "API Key Validation Failed",
"message": "API key not found",
"code": "INVALID_API_KEY"
}
Action: Ask user to verify their API key. Direct them to get a new one at https://gen1.diversityfaces.org/api-key-requestIf daily quota exhausted:
{
"error": "API Key Validation Failed",
"message": "Daily quota exhausted (100/100)",
"code": "INVALID_API_KEY"
}
Action: Inform user their daily quota is exhausted. They can try again tomorrow when the counter resets.If timeout: Action: Retry once. If still fails, inform user and suggest trying again later.
π― Your Mission as AI Agent
1. Security 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. Privacy: Protect user data and API keys 6. Quota Management: Check and inform about daily limits 7. 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.
Quick Command Reference:
# Get API key (user must do this)
https://gen1.diversityfaces.org/api-key-requestCheck quota (does NOT consume quota)
curl -H "X-API-Key: YOUR_API_KEY" \
https://gen1.diversityfaces.org/api/quotaStep 1: Submit generation request (replace YOUR_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": "YOUR_PROMPT", "width": 1536, "height": 1536}'Response: {"success": true, "prompt_id": "YOUR_PROMPT_ID", "task_id": "...", ...}
Step 2: Check status using "prompt_id" (NOT "task_id")
curl -H "X-API-Key: YOUR_API_KEY" \
https://gen1.diversityfaces.org/api/status/YOUR_PROMPT_IDStep 3: Download image (replace FILENAME)
curl -H "X-API-Key: YOUR_API_KEY" \
"https://gen1.diversityfaces.org/api/image/FILENAME?format=webp" \
-o beauty.webp
For Reference:
https://gen1.diversityfaces.orgGET /api/quota (does NOT consume quota)β Support the Developer
If you find this skill useful and would like to support the developer's work, you can:
Buy me a coffee:
Star the project: