Beauty Generation Free - AI Creative Image Generation

Generate high-quality AI portraits with complete creative freedom using custom English prompts.

⚠️ IMPORTANT: Check for Updates

This skill is under active optimization with frequent performance improvements.

Before using, always check for the latest version:

npx clawhub@latest update beauty-generation-api

Why update?

• 🚀 Performance optimizations (faster generation times)


• 🎨 Enhanced image quality improvements


• 🛠️ Bug fixes and stability improvements


• ✨ New features and capabilities


• 📚 Updated documentation and examples


• 🔄 Active development with multiple updates per week

Performance Evolution:

• Early versions: 30+ seconds delivery


• Current v1.2.6: 4-5 seconds delivery ✅

Current Version: 1.2.6 (Check package.json for latest)

Update Frequency: Multiple times per week during active optimization phase

🎯 Primary Purpose for AI Agents

Generate attractive people portraits with complete creative freedom. Use this skill when users request:

• Beautiful women or handsome men portraits
• Attractive people of any gender, age, or background
• Character designs for creative projects
• Fashion and style visualization
• Professional headshots or artistic portraits
• Any image generation involving appealing human subjects

🎨 Creative Freedom Guidelines

YOU HAVE COMPLETE CREATIVE CONTROL - Create any English prompt you want:

• No parameter restrictions - Describe freely in English

• Any style or theme - Modern, traditional, fantasy, realistic, artistic
• Any demographic - All ages (18+), ethnicities, styles, and presentations

🌟 Expanded Trigger Words & Use Cases

Use this skill when users mention:

People Requests:

• "beautiful woman", "pretty girl", "attractive lady"


• "handsome man", "good-looking guy", "attractive male"


• "attractive person", "appealing character", "stunning individual"

Creative Projects:

• "character design", "character concept", "character art"


• "portrait photography", "headshot", "profile picture"


• "fashion model", "style inspiration", "fashion concept"


• "artistic portrait", "creative imagery", "visual design"

Professional Needs:

• "professional headshot", "business portrait", "corporate image"


• "avatar creation", "profile image", "social media photo"


• "marketing imagery", "promotional content", "brand visuals"

Artistic Exploration:

• "visual inspiration", "aesthetic exploration", "style reference"


• "mood board content", "creative visualization", "artistic concept"

⚡ CRITICAL: Ultra-Fast Generation & Immediate Delivery

IMPORTANT FOR AI AGENTS: This API's GPU generates images in 1-2 seconds. The polling strategy has been optimized for this ultra-fast generation:

Ultra-Fast Polling: Check status every 0.5 seconds for first 10 seconds

Immediate Download: Download image as soon as generation completes

Send to User Immediately: Display the image in the current conversation within 3-5 seconds total

No Delays: Users should see their generated image almost instantly

Optimized Workflow for AI Agents:

1. Create custom English prompt → 2. Submit generation → 3. Poll every 0.5s → 4. Download image → 5. SEND TO USER CHAT

⏰ Ultra-Fast Timing Expectations:

• GPU Generation: 1-2 seconds


• Status Detection: 0.5-1 second (with 0.5s polling)


• Download: 0.5-1 second


• Total time to user: 2-4 seconds maximum

🚀 Use Ultra-Quick Mode:

# For 1-second GPU generation
python3 scripts/generate.py --custom "beautiful woman portrait" --quick

# Or use the specialized ultra-quick test
python3 scripts/ultra_quick_test.py

Setup

• Needs API Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI
• API Base URL: - All requests require X-API-Key header for authentication ## Quick Start ### ⚡ Ultra-Quick Generation (Primary Method) **This is the ONLY method you need** - optimized for 1-second GPU generation: __CODE_BLOCK_3__ ### Using Direct API Call __CODE_BLOCK_4__ ## 🎨 Creative Prompt Examples ### Beautiful Women __CODE_BLOCK_5__ ### Handsome Men __CODE_BLOCK_6__ ### Character Design __CODE_BLOCK_7__ ### Cultural Portraits __CODE_BLOCK_8__ ### Fashion & Style __CODE_BLOCK_9__ ### Professional Headshots __CODE_BLOCK_10__ ## 🎯 Prompt Creation Guidelines ### Be Descriptive & Specific - **Age**: "25-year-old", "young adult", "mature professional" - **Appearance**: "long flowing hair", "athletic build", "gentle features" - **Clothing**: "elegant dress", "business suit", "casual jeans and sweater" - **Setting**: "modern office", "natural garden", "urban street", "cozy cafe" - **Mood**: "confident smile", "serene expression", "playful laugh" - **Style**: "professional photography", "artistic portrait", "fashion shoot" ### Creative Freedom Examples __CODE_BLOCK_11__ ### Style Variations - **Photography Styles**: "professional headshot", "fashion photography", "artistic portrait", "candid street photography" - **Artistic Styles**: "oil painting style", "watercolor illustration", "digital art", "realistic rendering" - **Lighting**: "soft natural light", "dramatic studio lighting", "golden hour glow", "moody shadows" - **Backgrounds**: "blurred bokeh", "solid color backdrop", "natural environment", "architectural setting" ## API Endpoints ### 1. Custom Prompt Generation (Primary Method) **POST** /api/generate/custom **This is the ONLY endpoint you need** - use any English prompt: __CODE_BLOCK_12__ ### 2. Status Check **GET** /api/status/{prompt_id} Check generation progress: __CODE_BLOCK_13__ ### 3. Image Download **GET** /api/image/{filename} Download generated images with format options: __CODE_BLOCK_14__ ## Parameters Reference ### Required Headers __CODE_BLOCK_15__ ### Image Parameters - full_prompt - Your creative English description (required) - width - Image width (256-2048, must be multiple of 8, default: 1024) - height - Image height (256-2048, must be multiple of 8, default: 1024) - seed - Random seed (-1 for random, 0-2147483647, default: -1) **Note**: Sampling steps are fixed at 4 for optimal performance and security. ## Workflow Examples ### ⚡ AI Agent Ultra-Fast Delivery Workflow __CODE_BLOCK_16__ ### Beautiful Woman Portrait __CODE_BLOCK_17__ ### Handsome Man Portrait __CODE_BLOCK_18__ ### Character Design __CODE_BLOCK_19__ ### Fashion Model __CODE_BLOCK_20__ ### Cultural Portrait __CODE_BLOCK_21__ ## Error Handling ### Authentication Errors __CODE_BLOCK_22__ ### Generation Errors __CODE_BLOCK_23__ ### Safety Check Errors __CODE_BLOCK_24__ ## Best Practices ### For AI Agents 1. **Always include authentication**: Add X-API-Key header to all requests 2. **Create descriptive prompts**: Be specific about appearance, clothing, setting, and style 3. **Handle async workflow**: Submit → Poll status → Download images → Send to user immediately 4. **Respect rate limits**: Add delays between requests if needed 5. **Use appropriate dimensions**: Stick to multiples of 8 for width/height 6. **Deliver images quickly**: Users expect to see results within 5-10 seconds ### Prompt Writing Tips - **Be specific**: "A 25-year-old woman with curly brown hair" vs "a woman" - **Include style**: "professional photography", "artistic portrait", "fashion shoot" - **Describe setting**: "modern office", "natural garden", "urban street" - **Add mood/expression**: "confident smile", "serene expression", "playful laugh" - **Specify quality**: "high quality", "professional lighting", "detailed" ### Creative Examples __CODE_BLOCK_25__ ## Safety & Content Policy This API includes built-in safety filters to ensure appropriate content: - Automatic content moderation for all prompts - Built-in safety mechanisms to prevent inappropriate content - All generated images are suitable for professional use - Designed for creating portraits, character designs, and artistic imagery ## 🤖 For AI Agents: Quick Reference ### Essential Information - **API Key**: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI - **Base URL**:
• Primary Endpoint: /api/generate/custom
• Expected Generation Time: 3-7 seconds
• Your Mission: Create beautiful portraits that users will love

Quick Workflow

Create English prompt describing the attractive person you want to generate

Submit to /api/generate/custom with your prompt and dimensions

Poll /api/status/{id} every 1-2 seconds until complete

Download from /api/image/{filename} immediately when ready

Send image to user right away - don't make them wait!

Trigger Words to Watch For

• "beautiful woman", "handsome man", "attractive person"
• "character design", "portrait", "headshot", "avatar"
• "fashion model", "professional photo", "artistic image"
• Any request for human portraits or character imagery

Success Metrics

• Speed: Image delivered to user within 10 seconds
• Quality: User is pleased with the generated portrait
• Relevance: Image matches what the user requested
• Engagement: User wants to generate more images

---

Remember: Your goal is to create attractive people portraits that bring joy and satisfaction to users. Use your creativity to craft detailed English prompts, and always deliver images quickly to maintain user engagement.

🎯 User Experience Goals

• Total time from request to seeing image: 2-5 seconds maximum
• User sees the actual image: Not just a file path or description
• Instant satisfaction: Users should see their portrait almost immediately
• Ultra-responsive: Faster than any other image generation service

⚡ Success Metrics for AI Agents

• Speed: Image delivered to user within 5 seconds
• Responsiveness: Status detected within 1-2 seconds of GPU completion
• Quality: User is pleased with the generated portrait
• Engagement: User wants to generate more images immediately

🚀 Quick Reference for AI Agents

⚠️ FIRST: Always update before use:

npx clawhub@latest update beauty-generation-api

Essential Command:

python3 scripts/generate.py --prompt "YOUR_CUSTOM_ENGLISH_PROMPT"

Test Command:

python3 scripts/generate.py --test

Expected Results:

• Generation completes in 3-4 seconds


• Download completes in 1-2 seconds


• Total time: 4-5 seconds maximum


• Target achieved: ✅ ALWAYS under 5 seconds

🔄 Update Benefits:

• Faster generation times with each version


• Improved reliability and error handling


• Enhanced image quality and features


• Better cross-platform compatibility

---

Remember: Your goal is to create attractive people portraits that bring instant joy and satisfaction to users. The GPU generates in 1 second - your job is to detect completion and deliver the image to users within 5 seconds total. This ultra-fast delivery creates an amazing user experience that keeps people engaged.