Skip to main content

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.

​
Available Avatars

Click on an avatar to copy the avatar ID.
Use the copied avatar ID when creating your session token. See the Usage in Production 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} from your server to fetch fresh URLs. Never expose your API key in browser code. 
curl https://api.anam.ai/v1/avatars/30fa96d0-26c4-4e55-94a0-517025942e18 \
  -H "Authorization: Bearer $ANAM_API_KEY"
The response includes both fields: 
{
  "id": "30fa96d0-26c4-4e55-94a0-517025942e18",
  "displayName": "Cara",
  "variantName": "desk",
  "imageUrl": "https://lab.anam.ai/persona_thumbnails/cara_desk.png",
  "videoUrl": "https://anam-prod.../idling_video.mp4?X-Amz-Signature=..."
}
Use the video as a lightweight preview before the live session starts: 
<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.
Last modified on May 14, 2026