Skip to content
Last updated

List avatars

🔨 In Development — This section is still being developed and may change.
Get a list of all predefined avatars available for assistants and user profiles.
GEThttps://api.freddy.aitronos.com/v1/avatars

Returns a collection of predefined avatar images that can be used for assistants and user profiles. Each avatar includes a preview URL and metadata.

Returns

An array of Avatar objects.

Bash
curl "https://api.freddy.aitronos.com/v1/avatars" \
  -H "Authorization: Bearer $FREDDY_API_KEY"

Response

[
  {
    "id": "avt_robot_blue",
    "name": "Blue Robot",
    "url": "https://cdn.aitronos.com/avatars/robot-blue.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/robot-blue-thumb.png",
    "category": "robots",
    "tags": ["robot", "blue", "tech", "ai"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_assistant_purple",
    "name": "Purple Assistant",
    "url": "https://cdn.aitronos.com/avatars/assistant-purple.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/assistant-purple-thumb.png",
    "category": "assistants",
    "tags": ["assistant", "purple", "friendly"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_professional_teal",
    "name": "Teal Professional",
    "url": "https://cdn.aitronos.com/avatars/professional-teal.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/professional-teal-thumb.png",
    "category": "professional",
    "tags": ["professional", "teal", "business"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_creative_orange",
    "name": "Orange Creative",
    "url": "https://cdn.aitronos.com/avatars/creative-orange.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/creative-orange-thumb.png",
    "category": "creative",
    "tags": ["creative", "orange", "artistic"],
    "size": {
      "width": 512,
      "height": 512
    }
  },
  {
    "id": "avt_support_green",
    "name": "Green Support",
    "url": "https://cdn.aitronos.com/avatars/support-green.png",
    "previewUrl": "https://cdn.aitronos.com/avatars/previews/support-green-thumb.png",
    "category": "support",
    "tags": ["support", "green", "helpful"],
    "size": {
      "width": 512,
      "height": 512
    }
  }
]

Avatar Categories

Avatars are organized into the following categories:

  • robots - Robot and AI-themed avatars
  • assistants - Friendly assistant characters
  • professional - Business and professional avatars
  • creative - Artistic and creative avatars
  • support - Customer support themed avatars
  • technical - Developer and technical avatars
  • abstract - Abstract and geometric designs

Usage

To use an avatar with an assistant:

{
  "name": "My Assistant",
  "avatarId": "avt_robot_blue",
  "model": "ftg-3.0"
}

You can also use a custom avatar URL instead:

{
  "name": "My Assistant",
  "avatar": "https://example.com/my-custom-avatar.png",
  "model": "ftg-3.0"
}
Previous page
Next page