Quick Start
Generate your first image in 5 minutes.
Quick Start
Generate your first AI image in under 5 minutes.
1. Join the Waitlist
SMAvatar is currently in alpha. Join the waitlist to get early access.
2. Create a Project and API Key
- Click Create Project on your dashboard
- Open your project and go to the API Keys tab
- Click Create API Key and copy it immediately
Save your API key now. You won't see it again.
3. Generate an Avatar
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": "cartoon_flat_modern",
"quality": "standard",
"size": "square",
"parameters": {
"subject": "fox",
"theme": "astronaut",
"gender": "neutral",
"color": "orange"
}
}'
Response:
{
"success": true,
"job": {
"id": "abc123-def456-...",
"job_type": "avatar",
"status": "pending",
"estimated_token_cost": 2
}
}
4. Poll for Completion
Jobs complete quickly:
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", the response includes an assets array with your image.
5. Download Your Image
Construct the URL from the storage_path:
https://hxqvyxnnppomqqwglxwo.supabase.co/storage/v1/object/public/avatars/{storage_path}
Generate a Map
Find a Location
curl 'https://api.smavatar.com/api/mcp/tools/list-locations?type=country'
Returns locations with their IDs:
{
"data": [
{
"id": "bdd56f14-e776-418a-ab18-89c8138df978",
"name": "United States of America",
"location_code": "us"
}
]
}
Create 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 quickly. Poll the same way as avatars.