Introduction

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

What is SMAvatar?

SMAvatar is a REST API that generates AI-powered avatars and educational maps programmatically. Submit a request, and receive a high-quality image in seconds.

Two APIs, One Platform

Avatar Generation

Create unique, stylized avatars using GPT-Image-1. Perfect for user profiles, games, and applications.

Map Generation

Generate educational maps with countries, states, rivers, and lakes. Built for geography education.

Use Cases

Avatars

User Profiles - Generate unique avatars for app users
Gaming - Create character portraits and NPCs
Education - Student profiles with customizable characters
Social Apps - Profile pictures with consistent art styles

Maps

Geography Education - Quiz materials, worksheets, study guides
EdTech Platforms - Interactive map exercises
Content Creation - Presentations and educational content
AI Assistants - Let LLMs generate maps through conversation

How It Works

Both APIs follow the same simple pattern:

sequenceDiagram
    participant You
    participant API
    participant Worker
    participant Storage

    You->>API: POST /jobs/avatars (or /jobs/maps)
    API->>You: Job created (pending)
    Worker->>API: Process job
    Worker->>Storage: Upload image
    You->>API: GET /jobs/{jobId}
    API->>You: Job complete + image URL

Create a job - Send your parameters (style, colors, location, etc.)
Job queued - Our worker picks it up within seconds
Image generated - AI generates your visual and uploads to storage
Download - Get your high-resolution image

Quick Examples

Generate an Avatar

curl -X POST 'https://api.smavatar.com/api/v1/projects/{project_id}/jobs/avatars' \
  -H 'Authorization: Bearer {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"
    }
  }'

Generate a Map

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

Pricing

SMAvatar uses a simple token-based pricing model:

Action	Token Cost
Avatar (Economy)	25 tokens
Avatar (Standard)	50 tokens
Avatar (High)	100 tokens
Map Generation	50 tokens

New users get 100 free tokens on signup - enough to try both APIs.

Next Steps

Quick Start

Generate your first image in 5 minutes.

Avatar API

Learn about styles, parameters, and customization.

Maps API

Explore locations, features, and themes.

MCP Integration

Connect LLMs to generate visuals through conversation.

Quick Start

Generate your first image in 5 minutes.