Guides
AI Integration

AI Providers

Avatarium supports multiple AI providers for conversation intelligence.

Available Providers

ProviderDefault ModelBest For
Anthropic (default)claude-haiku-4-5-20251001Fast, nuanced conversations
OpenAI (BYOK)gpt-4oComplex reasoning
Google (BYOK)gemini-2.5-flashMultimodal capabilities
Groq (BYOK)llama-3.3-70b-versatileUltra-fast, cost-effective

The built-in brain uses Anthropic Claude. To use other providers, configure BYOK or External Brain.

Configuration

In the Dashboard

Go to Dashboard → Avatar Settings → Brain to select your AI provider and model.

Via SDK (BYOK)

import { AvatariumEmbed } from '@avatarium/react';
 
<AvatariumEmbed
  shortId="8yb8p7oj3sK"
  byokAI={{
    provider: 'anthropic',
    apiKey: process.env.NEXT_PUBLIC_ANTHROPIC_KEY,
    model: 'claude-sonnet-4-6'
  }}
/>

Provider Details

Anthropic (Default)

Anthropic Claude is the built-in provider – zero setup, zero API keys required.

Free / Starter plans:

  • claude-haiku-4-5-20251001 – fast, efficient, great for most conversations

Plus / Premium / Elite plans:

  • claude-sonnet-4-6 – more capable, better at nuanced reasoning

OpenAI (BYOK)

  • Models: gpt-4o, gpt-4o-mini, gpt-4.1
  • Best for: Complex reasoning, detailed technical responses
  • Requires your own OpenAI API key via BYOK

Google (BYOK)

  • Models: gemini-2.5-pro, gemini-2.5-flash
  • Best for: Multimodal understanding, structured data
  • Requires your own Google AI API key via BYOK

Groq (BYOK)

  • Models: llama-3.3-70b-versatile, mixtral-8x7b-32768
  • Best for: Ultra-low latency, high-throughput use cases
  • Requires your own Groq API key via BYOK

Custom System Prompts

Configure a custom system prompt for any provider in Dashboard → Avatar Settings → Personality:

<AvatariumEmbed
  shortId="8yb8p7oj3sK"
  systemPrompt={`
    You are a customer support agent for a software company.
    Be helpful, concise, and professional.
    If you don't know the answer, offer to connect the user with a human agent.
  `}
/>

Related