> ## Documentation Index
> Fetch the complete documentation index at: https://anam.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Creating Custom Avatars

> How to create custom avatars using Anam Lab or the API

Anam's one-shot avatar generator creates a personalized avatar from a single photo. You can use any face — a real person, a stock photo, or an AI-generated image — and the system produces an avatar that can speak, express, and hold conversations.

## Create in Anam Lab

<Steps>
  <Step title="Open the Build page">
    Go to [lab.anam.ai/build](https://lab.anam.ai/build) and select the **Avatar** tab.
  </Step>

  <Step title="Add a new avatar">
    Click the **Add** button, then either upload a photo or capture one with your webcam. For best results, follow the [best practices](/concepts/custom-avatars).
  </Step>

  <Step title="Generate">
    Click **Create** and wait for your avatar to be generated. Once ready, it's available for use in any persona.
  </Step>
</Steps>

## Create via API

For programmatic avatar creation, use the [Create Avatar](/api-reference/avatars/create-avatar) endpoint. This is useful for building custom onboarding flows or batch-creating avatars.

```javascript theme={"system"}
const response = await fetch("https://api.anam.ai/v1/avatars", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: `Bearer ${apiKey}`,
  },
  body: JSON.stringify({
    displayName: "My Custom Avatar",
    imageUrl: "https://example.com/photo.jpg",
  }),
});
```

## Using your avatar

Once created, reference the avatar by its ID in your persona configuration:

```javascript theme={"system"}
const personaConfig = {
  name: "My Persona",
  avatarId: "your-custom-avatar-id",
  voiceId: "6bfbe25a-979d-40f3-a92b-5394170af54b",
  llmId: "a7cf662c-2ace-4de1-a21e-ef0fbf144bb7",
  systemPrompt: "You are a helpful assistant.",
};
```

You can find the avatar ID in Lab by clicking the three-dot menu on any avatar and selecting **Copy ID**.