Skip to main content
GET
/
v1
/
avatars
/
{id}
get avatar
curl --request GET \
  --url https://api.anam.ai/v1/avatars/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "071b0286-4cce-4808-bee2-e642f1062de3",
  "displayName": "Liv",
  "variantName": "home",
  "imageUrl": "https://lab.anam.ai/persona_thumbnails/liv_home.png",
  "videoUrl": "https://anam-prod.r2.cloudflarestorage.com/avatars/v2/stock/liv_home/idling_video.mp4?X-Amz-Signature=...",
  "createdAt": "2026-04-20T10:00:00.000Z",
  "updatedAt": "2026-04-20T10:00:00.000Z",
  "createdByOrganizationId": null,
  "availableVersions": [
    "v1",
    "v2",
    "cara-4-3"
  ],
  "activeVersion": "v2"
}

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.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string<uuid>
required

Avatar ID

Response

Successfully retrieved avatar

A face preset that a persona can use as its visual representation.

​
id
string<uuid>

Unique identifier for the avatar.

​
displayName
string

Human-readable name shown in the Lab and share links.

​
variantName
string

Name of the specific variant (e.g. lighting or pose) within the avatar family.

​
imageUrl
string<uri>

URL of the still image used as a preview of the avatar.

​
videoUrl
string<uri> | null

Signed URL for a muted idling MP4 preview of the avatar, if one exists. The URL expires after 1 hour; re-fetch the avatar to get a fresh URL. null when the preview is unavailable or still generating.

​
createdAt
string<date-time>

Timestamp when the avatar was created.

​
updatedAt
string<date-time>

Timestamp when the avatar was last updated.

​
createdByOrganizationId
string | null

ID of the organization that created the avatar, or null for stock avatars. IDs may be either UUIDs or nanoid-style strings depending on when the organization was created.

​
availableVersions
string[]

Internal avatar version identifiers this avatar has generated assets for. Current public model mappings are v1 = cara-2, v2 = cara-3, and cara-4-* = cara-4-latest. Use the public avatarModel request field when selecting a model.

​
activeVersion
string

Internal avatar version used by default when no explicit avatarModel is requested. Current public model mappings are v1 = cara-2, v2 = cara-3, and cara-4-* = cara-4-latest.

Last modified on May 12, 2026