Avatars

GET /v1/avatars

curl https://api.avatarium.ai/v1/avatars \
  -H "Authorization: Bearer av_live_xxxxx"

{
  "avatars": [
    {
      "id": "aria-001",
      "name": "Aria",
      "description": "Friendly and professional assistant",
      "preview_url": "https://cdn.avatarium.ai/previews/aria-001.webp",
      "model_url": "https://cdn.avatarium.ai/models/aria-001.glb",
      "default_voice": "en-US-Neural2-F",
      "tags": ["professional", "friendly", "female"]
    },
    {
      "id": "max-001",
      "name": "Max",
      "description": "Energetic and helpful guide",
      "preview_url": "https://cdn.avatarium.ai/previews/max-001.webp",
      "model_url": "https://cdn.avatarium.ai/models/max-001.glb",
      "default_voice": "en-US-Neural2-D",
      "tags": ["energetic", "casual", "male"]
    }
  ]
}

GET /v1/avatars/:id

curl https://api.avatarium.ai/v1/avatars/aria-001 \
  -H "Authorization: Bearer av_live_xxxxx"

{
  "id": "aria-001",
  "name": "Aria",
  "description": "Friendly and professional assistant with a warm demeanor",
  "preview_url": "https://cdn.avatarium.ai/previews/aria-001.webp",
  "model_url": "https://cdn.avatarium.ai/models/aria-001.glb",
  "animations": {
    "idle": "idle_breathing",
    "talking": "talk_gesture",
    "thinking": "think_look"
  },
  "voice": {
    "default": "en-US-Neural2-F",
    "alternatives": [
      "en-GB-Neural2-A",
      "en-AU-Neural2-A"
    ]
  },
  "traits": {
    "personality": "friendly, professional, helpful",
    "speaking_style": "clear, warm, encouraging"
  },
  "tags": ["professional", "friendly", "female"]
}