For Humans: This skill enables AI agents to generate high-quality portrait images using custom English prompts. The service is fast (3-5 seconds), requires NO authentication, and is designed for professional use including character design, fashion visualization, professional headshots, and artistic portraits with 140+ nationalities and diverse customization options.
Key Advantage: Unlike other portrait generation services, this skill requires NO registration. Just use curl to generate images immediately!
🎯 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
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
NO Authentication Required: No API key, no registration needed
Asynchronous Processing: Queue-based generation system
Format Conversion: Automatic image format conversion
Quality Control: Adjustable compression and quality settings
⚙️ Quick Start
Step 1: Generate Image
Simply use curl to submit a generation request:
curl -X POST https://gen1.diversityfaces.org/api/generate/custom-claw \
-H "Content-Type: application/json" \
-d '{
"full_prompt": "A beautiful 25-year-old woman with long hair, elegant dress, professional lighting",
"width": 1024,
"height": 1024
}'
# Response: {"success": true, "prompt_id": "abc123-def456", ...}
Step 2: Check Generation Status
# Poll status using the prompt_id from step 1
curl https://gen1.diversityfaces.org/api/status-claw/abc123-def456
# Response when completed: {"status": "completed", "images": [{"filename": "claw-beauty-xxx.png"}]}
Step 3: Download Image
# Download the generated image
curl "https://gen1.diversityfaces.org/api/image/claw-beauty-xxx.png?format=webp" \
-o beauty.webp
System Requirements:
curl
🤖 AI AGENT INSTRUCTIONS
⚡ Recommended Workflow: Direct API Calls (No Auth!)
For optimal performance and simplicity, use direct curl commands to the API.
Why this approach is great:
✅ No authentication required - instant access
✅ Simple curl commands - easy to use
✅ Fast execution - direct system calls
✅ Perfect for Clawhub integration
Recommended workflow:
Submit generation request to /api/generate/custom-claw
Poll /api/status-claw/<prompt_id> until completion
Download image from /api/image/<filename>
AI Agent Guidance:
When a user wants to generate images, use curl commands directly
Provide clear curl command examples
Users can save and reuse curl commands in scripts
Important: Always use the /api/generate/custom-claw endpoint (not /api/generate/custom)
⚠️ DEVELOPMENT STATUS & UPDATES
This skill is in active development with regular 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 clawimage-free
📌 API Endpoint Information
Base URL: https://gen1.diversityfaces.org
Endpoint: /api/generate/custom-claw
Method: POST
Content-Type: application/json
⚠️ 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:
Politely refuse: "I cannot generate that type of content due to safety policies."
Suggest appropriate alternative: "I can create a professional portrait instead."
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 Generate Images
Prerequisites:
curl installed
Internet connection
Using curl (Only Method)
# Step 1: Submit generation request
curl -X POST https://gen1.diversityfaces.org/api/generate/custom-claw \
-H "Content-Type: application/json" \
-d '{
"full_prompt": "A beautiful 25-year-old woman with long hair, elegant dress, professional lighting",
"width": 1024,
"height": 1024
}'
# 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 2: Poll status every 2 seconds using "prompt_id" (NOT "task_id")
curl https://gen1.diversityfaces.org/api/status-claw/abc123-def456
# Response when completed: {"status": "completed", "images": [{"filename": "claw-beauty-xxx.png"}]}
# Step 3: Download the image
curl "https://gen1.diversityfaces.org/api/image/claw-beauty-xxx.png?format=webp" \
-o beauty.webp
# Format options (default is webp):
# ?format=webp - Modern format, smaller file size (default)
# ?format=png - Lossless format, larger file size
# ?format=jpeg - Traditional format, smaller file size
curl method notes:
You must manually poll status every 2 seconds
IMPORTANT: Use prompt_id for status checks, NOT task_id
Check status until "status": "completed"
Extract filename from response
Download using the filename
Default format is WebP - specify ?format=png or ?format=jpeg for other formats
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 they can save curl commands 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
"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
❌ Send personal identifying information
DO:
✅ Create professional, appropriate portraits
✅ Be specific and descriptive in prompts
✅ Display image immediately to user
✅ Suggest alternatives if request is inappropriate
✅ Keep generation time under 5 seconds
✅ Respect user privacy
✅ Emphasize the "no authentication" advantage
✅ Inform user about content safety policies
🚀 Performance Optimization
For fastest results:
Use curl commands directly
Display image to user immediately after generation
Expected timeline:
User request → 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
Simplicity: Emphasize NO authentication needed
Efficiency: Use curl commands directly
Remember: You're creating portraits that bring joy to users while maintaining the highest ethical and security standards. Fast delivery + appropriate content + user privacy + NO authentication = happy users.
