> ## 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.

# Avatar Gallery

> Browse available Anam avatars, preview their appearance, and copy the avatar identifier needed when creating or updating a persona.

## Premium Avatars

Click on an avatar to copy the avatar ID.

> [!NOTE]
>
> Use the copied avatar ID when creating your session token. See the [Usage in
> Production](https://anam.ai/docs/production.md) guide for more information.

## Avatar media

Fetch an avatar resource to get the media URLs for your own app:

* `imageUrl` is the still preview image used for selection screens and loading states.
* `videoUrl` is a muted idling MP4 preview, about 30 seconds long, or `null`
  if the video is still generating.

Call [GET `/v1/avatars/{id}`](https://anam.ai/docs/api-reference/avatars/get-avatar) from your
server to fetch fresh URLs. Never expose your API key in browser code.

```bash theme={"system"}
curl https://api.anam.ai/v1/avatars/071b0286-4cce-4808-bee2-e642f1062de3 \
  -H "Authorization: Bearer $ANAM_API_KEY"
```

The response includes both fields:

```json theme={"system"}
{
  "id": "071b0286-4cce-4808-bee2-e642f1062de3",
  "displayName": "Liv",
  "variantName": "home",
  "imageUrl": "https://lab.anam.ai/persona_thumbnails/liv_home.png",
  "videoUrl": "https://anam-prod.../idling_video.mp4?X-Amz-Signature=..."
}
```

Use the video as a lightweight preview before the live session starts:

```jsx theme={"system"}
<video
  src={avatar.videoUrl}
  autoPlay
  loop
  muted
  playsInline
  style={{ width: "100%", objectFit: "cover" }}
/>
```

When the user starts a session, replace this preview video with the live WebRTC
stream. `videoUrl` values are signed URLs that expire after 1 hour, so fetch
them when you need them. For long-lived pages, CMS content, static widget
configuration, or high-traffic selection screens, download the MP4 server-side
and serve it from your own CDN.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.