Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Bumped version to 1.2.42 for documentation upgrades. - No code or functional changes; content remains the same. - Updated version metadata in documentation for consistency.
What This Skill Does
Generates AI portrait images from text prompts via the gen1.diversityfaces.org API. Supports 140+ nationalities, 8 styles, and customizable appearance options including hair, skin tone, mood, and background. Returns images in WebP, PNG, or JPEG within 3-10 seconds.
Free API keys with 500 calls are issued instantly without payment or trial negotiation, making the service usable immediately.
When to use it
- Generating a professional headshot for a LinkedIn profile
- Creating character portraits for a game or novel
- Visualizing outfit styles on a fashion-inspired model
- Producing diverse avatar images for an app's sample user data
- Designing culturally specific portraits for a presentation
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Generate a professional headshot of a woman in her 30s wearing a navy blazer
- 1Check remaining daily quota via GET /api/quota
- 2Submit generation request to POST /api/generate/custom with the text prompt and dimensions
- 3Poll GET /api/status/<prompt_id> every 0.5 seconds until status is 'completed'
- 4Extract filename from the completed status response
- 5Download the image via GET /api/image/<filename>?format=webp and save locally
A 1024x1024 WebP portrait image saved as beauty.webp
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.