Introduction
# Beauty Generation Free - AI Agent Skill **For Humans**: This skill enables AI agents to generate high-quality portrait images of attractive people using custom English prompts. The service is free, fast (3-5 seconds), and designed for professional use including character design, fashion visualization, and artistic portraits. --- ## ⚙️ Quick Start This skill is pre-configured with a free API key - **no setup needed**, just use it directly: ```bash python3 scripts/generate.py --prompt "A beautiful woman with long hair" ``` **System Requirements:** - Python 3 - curl --- ## 🤖 AI AGENT INSTRUCTIONS ### 📌 IMPORTANT: How to Get Your Free API Key **This skill is pre-configured with a free API key - no setup needed!** The skill automatically uses the official free API key: `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI` Just run the script and start generating images immediately. --- ### ⚠️ 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 **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:** - Python 3 installed - curl installed --- **Method 1: Using generate.py (Recommended)** ```bash # Just run the script - API key is already configured python3 scripts/generate.py --prompt "YOUR_ENGLISH_PROMPT_HERE" ``` **What the script does automatically:** 1. Uses the pre-configured free API key 2. Submits your prompt to API 3. Polls status every 0.5 seconds 4. Downloads image when ready (1-2 seconds) 5. Saves locally and returns file path 6. **Total time: 3-5 seconds** **Examples:** ```bash # Professional woman portrait python3 scripts/generate.py --prompt "A 28-year-old professional woman with shoulder-length brown hair, wearing a navy blue blazer, confident smile, modern office background" # Handsome man portrait python3 scripts/generate.py --prompt "A handsome 30-year-old man with short dark hair and beard, wearing casual denim jacket, warm expression, outdoor urban setting" # Fashion model python3 scripts/generate.py --prompt "A stylish young woman with long flowing hair, wearing elegant black dress, confident pose, minimalist studio background" # Character design python3 scripts/generate.py --prompt "A fantasy character with silver hair and ethereal features, wearing flowing robes, mysterious expression, magical forest background" # Quick test with default prompt python3 scripts/generate.py --test # Custom size python3 scripts/generate.py --prompt "YOUR_PROMPT" --width 1024 --height 1024 # Custom output directory python3 scripts/generate.py --prompt "YOUR_PROMPT" --output-dir ./my_images ``` --- **Method 2: Using curl (Alternative)** If you can't use Python, use curl commands: ```bash # Step 1: Submit generation request curl -X POST https://gen1.diversityfaces.org/api/generate/custom \ -H "Content-Type: application/json" \ -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \ -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: Poll status every 0.5 seconds until completed curl -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \ https://gen1.diversityfaces.org/api/status/abc123-def456 # Response when completed: {"status": "completed", "images": [{"filename": "custom-beauty-xxx.png"}]} # Step 3: Download the image curl -H "X-API-Key: ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI" \ "https://gen1.diversityfaces.org/api/image/custom-beauty-xxx.png?format=webp" \ -o beauty.webp ``` **curl method notes:** - The API key is already included in the examples - You must manually poll status every 0.5 seconds - Check status until `"status": "completed"` - Extract filename from response - Download using the filename - Total time: 3-5 seconds if polling correctly --- **After generation (both methods):** - **Display the image to user immediately** - Don't just show the file path - User should see the actual image within 5 seconds --- ### 📝 How to Create Prompts **Prompt structure:** ``` "A [age] [gender] with [appearance details], wearing [clothing], [expression/mood], [setting/background], [photography style]" ``` **Good prompt examples:** ```python # 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 --- ### 🔧 Technical Details (For Reference Only) **You don't need to use these directly - `generate.py` handles everything.** **API Configuration:** - **Base URL**: `https://gen1.diversityfaces.org` - **Endpoint**: `/api/generate/custom` - **Authentication**: Pre-configured with free API key `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI` **Parameters (handled by generate.py):** - `full_prompt`: Your English description - `width`: 256-2048, multiple of 8, default 1024 - `height`: 256-2048, multiple of 8, default 1024 - `seed`: -1 for random **Timing:** - GPU generation: 1-2 seconds - Status polling: 0.5-1 second (every 0.5s) - Download: 0.5-1 second - **Total: 3-5 seconds** --- ### ✅ Success Checklist Before sending response to user, verify: - [ ] Prompt is appropriate and safe - [ ] Image generated successfully (3-5 seconds) - [ ] Image is displayed to user (not just file path) - [ ] User can see the actual image in conversation - [ ] Total time from request to display < 10 seconds --- ### 🎨 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:** - ❌ 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 **DO:** - ✅ Create professional, appropriate portraits - ✅ Be specific and descriptive in prompts - ✅ Display image immediately to user - ✅ Suggest alternatives if request is inappropriate - ✅ Update skill before first use - ✅ Keep generation time under 5 seconds --- ### 🚀 Performance Optimization **For fastest results:** 1. Always update skill first: `` 2. Use the `generate.py` script (it's optimized for speed) 3. Display image to user immediately after generation **Expected timeline:** ``` User request → Create prompt (instant) → Run generate.py (3-5s total) → Display to user (instant) → TOTAL: 3-5 seconds ``` --- ### 📊 Error Handling **If generation fails:** ```python { "success": false, "error": "安全检查失败", "code": "SECURITY_VIOLATION" } ``` **Action**: Inform user the prompt was rejected due to safety filters. Suggest appropriate alternative. **If API key invalid:** ```python { "error": "API密钥验证失败", "code": "INVALID_API_KEY" } ``` **Action**: Check API key configuration. Contact support if needed. **If timeout:** **Action**: Retry once. If still fails, inform user and suggest trying again later. --- ### 🎯 Your Mission as AI Agent 1. **Safety 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. **Engagement**: Make users excited about the result **Remember**: You're creating portraits that bring joy to users while maintaining the highest ethical standards. Fast delivery + appropriate content = happy users. --- **Quick Command Reference:** ```bash # Generate image with prompt python3 scripts/generate.py --prompt "YOUR_PROMPT" # Quick test python3 scripts/generate.py --test # Custom size python3 scripts/generate.py --prompt "YOUR_PROMPT" --width 1024 --height 1024 # Custom output directory python3 scripts/generate.py --prompt "YOUR_PROMPT" --output-dir ./images ``` **For Reference:** - **Base URL**: `https://gen1.diversityfaces.org` - **Free API Key**: `ak_OymjErKQRs-brINJuHFxKwIbxbZHq2KRiEzYthnwxMI` (pre-configured)