Quick Start

Generate your first image in 5 minutes.

Quick Start

Get your first AI-generated image in under 5 minutes.

Step 1: Create an Account

Go to app.smavatar.com/auth/signup
Create your account (email + password)
You'll automatically receive 100 free tokens

Step 2: Create a Project & API Key

After login, you'll land on the dashboard
Click "Create Project" and give it a name
Go to your project → API Keys tab
Click "Create API Key" and copy it

Save your API key immediately! You won't be able to see it again. If you lose it, create a new one.

Step 3: Generate Your First Avatar

Open your terminal and run:

curl -X POST 'https://api.smavatar.com/api/v1/projects/YOUR_PROJECT_ID/jobs/avatars' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "style_id": "pixar-3d",
    "quality": "standard",
    "size": "square",
    "parameters": {
      "subject": "fox",
      "theme": "warrior",
      "gender": "female",
      "color": "orange"
    }
  }'

You'll get a response like:

{
  "success": true,
  "job": {
    "id": "abc123-def456-...",
    "job_type": "avatar",
    "status": "pending",
    "estimated_token_cost": 50
  },
  "message": "Avatar job created successfully."
}

Step 4: Check Job Status

Poll for completion (jobs typically complete in ~10 seconds):

curl 'https://api.smavatar.com/api/v1/projects/YOUR_PROJECT_ID/jobs/avatars/JOB_ID' \
  -H 'Authorization: Bearer YOUR_API_KEY'

When status is "completed", you'll get an image URL in the assets array.

Step 5: Download Your Image

The response includes a storage_path - construct the full URL:

https://hxqvyxnnppomqqwglxwo.supabase.co/storage/v1/object/public/avatars/{storage_path}

Open that URL to see your AI-generated avatar!

Try a Map Instead

Want to generate a map? Here's how:

Find a Location ID

First, discover available locations:

curl 'https://api.smavatar.com/api/mcp/tools/list-locations?type=country'

This returns locations like:

{
  "data": [
    {
      "id": "bdd56f14-e776-418a-ab18-89c8138df978",
      "name": "United States of America",
      "location_code": "us"
    }
  ]
}

Generate the Map

curl -X POST 'https://api.smavatar.com/api/v1/projects/YOUR_PROJECT_ID/jobs/maps' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{
    "location_id": "bdd56f14-e776-418a-ab18-89c8138df978",
    "width": 1400,
    "height": 900,
    "theme": "modern",
    "output_format": "png"
  }'

Maps complete in ~5 seconds. Poll for status the same way as avatars.

What's Next?

Authentication

Learn about API keys, projects, and security.

Avatar Styles

Explore all available art styles.

Map Themes

See all map themes and customization options.

Introduction

SMAvatar is an AI-powered visual generation API for avatars and maps.

Authentication

API keys, projects, and security best practices.