beauty-generation-api

• You need to generate professional headshots or business portraits for profiles, presentations, or marketing materials.
• You are building a game, story, or creative project and need character design or avatar images representing diverse ethnicities and styles.
• You want fashion visualization or style inspiration imagery featuring model-quality portraits.
• You need culturally diverse portrait photography representing specific nationalities, traditional clothing, or cultural backgrounds.

• You need to generate images of real, named individuals (celebrities, public figures) — this skill prohibits that use.
• You require high-volume generation beyond the daily quota (default 1,000 calls/day) without waiting for resets.
• You need images of non-portrait subjects (landscapes, objects, animals, etc.) — this skill is focused exclusively on human portraits.

Generate portraits representing over 140 nationalities and cultures, with 22 skin tones, 22 hair styles and colors, and traditional or modern clothing options. This makes it well-suited for projects requiring authentic diverse representation.

The asynchronous queue-based system delivers completed images in 3–5 seconds of GPU processing time. With status polling and direct download, the full workflow from request to image takes under 10 seconds.

Choose from 8 portrait styles (Pure, Sexy, Classical, Modern, and more), 24 moods and expressions, and 24 scene backgrounds. Output supports WebP, PNG, and JPEG with adjustable quality and resolution up to 2048×2048.

The API enforces content safety rules server-side, automatically rejecting prompts that request minors, nudity, violence, hate speech, or other prohibited content. The skill also instructs the AI agent to refuse such requests before submission.

Each free API key includes 500 total calls with a default daily limit of 1,000 calls. A dedicated /api/quota endpoint lets agents check remaining quota without consuming any calls, enabling proactive limit management.

The skill provides ready-to-use Python and Bash script templates that automate the full generate → poll → download pipeline. Running locally reduces token usage by an estimated 70–80% compared to issuing each curl command through the agent conversation.

Describe a person's age, gender, clothing, and expression to produce a polished corporate headshot in seconds. Useful for creating placeholder portraits for presentations, mockups, or internal tools without a photo shoot.

Specify fantasy or sci-fi attributes — armor, hair color, setting, art style — to generate character reference images for tabletop RPGs, video games, or novels. The wide nationality and style range supports diverse casts.

Create fashion model images by describing clothing, pose, and background. Useful for mood boards, e-commerce mockups, or style concept exploration without requiring a physical shoot.

Generate profile avatars representing specific cultural backgrounds, traditional dress, or regional aesthetics. Suitable for apps, platforms, or educational materials that need inclusive visual representation.