Skill File

---
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