agent-docs

AI Avatar Generator Skill for Agents

AI agent skill for generating avatar images via AI Pass API. Curl and Python examples.

EiliyaFebruary 13, 20261 min read

AI Avatar Generator Skill for Agents

A ready-to-use skill for AI agents to generate avatar images via the AI Pass API.

Quick Start

Set your API key as $AIPASS_API_KEY (get one at the Developer Dashboard).

Generate an Avatar

curl -s -X POST https://aipass.one/apikey/v1/images/generations \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro/v1.1",
    "prompt": "Cartoon style avatar portrait: friendly robot with blue eyes, centered, profile picture",
    "size": "1024x1024",
    "n": 1
  }'

Response path: data[0].url

Parameters

model: flux-pro/v1.1 (high quality)
prompt: Include style + description + "centered, profile picture"
Styles: cartoon, anime, watercolor, pixel art, 3D render, professional illustration

Pricing

$1 free credit on signup
Pay as you go

For AI agents

Skill file

Download

---
name: avatar-generator
description: Generate custom avatar images from text descriptions using AI Pass image generation API.
version: 1.0.0
---

# Avatar Generator Skill

Generate avatar/profile picture images using AI.

## Requirements
- AI Pass API key (create at https://aipass.one/panel/developer.html)
- Set as environment variable: `$AIPASS_API_KEY`

## Usage

### Generate Avatar (curl)
```bash
curl -s -X POST https://aipass.one/apikey/v1/images/generations \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro/v1.1",
    "prompt": "Cartoon style avatar portrait: friendly robot with blue glowing eyes, clean background, centered composition, suitable for profile picture",
    "size": "1024x1024",
    "n": 1
  }'
```

Response: `r.data[0].url` — URL of the generated avatar image.

### With Style Variations
```bash
curl -s -X POST https://aipass.one/apikey/v1/images/generations \
  -H "Authorization: Bearer $AIPASS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "flux-pro/v1.1",
    "prompt": "Anime style avatar: girl with purple hair and headphones, vibrant colors, centered portrait, profile picture",
    "size": "1024x1024",
    "n": 1
  }'
```

### Python
```python
import requests, os

def generate_avatar(description, style="cartoon"):
    r = requests.post(
        "https://aipass.one/apikey/v1/images/generations",
        headers={
            "Authorization": f"Bearer {os.environ['AIPASS_API_KEY']}",
            "Content-Type": "application/json"
        },
        json={
            "model": "flux-pro/v1.1",
            "prompt": f"{style} style avatar portrait: {description}. Centered, square composition, suitable for profile picture.",
            "size": "1024x1024",
            "n": 1
        }
    )
    return r.json()["data"][0]["url"]

url = generate_avatar("a wizard with a long beard", "watercolor painting")
print(f"Avatar URL: {url}")
```

## Notes
- Model: `flux-pro/v1.1` (high quality image generation)
- $1 free credit on signup at https://aipass.one
- Create API key at https://aipass.one/panel/developer.html

## Related
- App: https://aipass.one/apps/avatar-gen
- User guide: https://aipass.one/blog/ai-avatar-generator-online
- Dev tutorial: https://aipass.one/blog/build-ai-avatar-generator

Related apps

avatar gen