clawimage-free

What this skill does

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

**Professional AI-Powered Portrait Generation**

**Powered by [diversityfaces.org](https://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:

```bash

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

```bash
# 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

```bash
# 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:**
```bash
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)**

```bash

# 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 im