Clawimage Free

🎨 ClawImage Free - AI Portrait Generator (No Auth Required)

Professional AI-Powered Portrait Generation

Powered by diversityfaces.org

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

1. Submit generation request to /api/generate/custom-claw
2. Poll /api/status-claw/<prompt_id> until completion
3. 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:

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 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
• Include setting/background details
• Specify mood/expression
• Add photography or art style
• Use descriptive adjectives
• Keep it professional and appropriate
• Do NOT include personal identifying information