get avatar
Returns an avatar by ID
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Path Parameters
Avatar ID
Response
Successfully retrieved avatar
A face preset that a persona can use as its visual representation.
Unique identifier for the avatar.
Human-readable name shown in the Lab and share links.
Name of the specific variant (e.g. lighting or pose) within the avatar family.
URL of the still image used as a preview of the avatar.
Preview image cropped exactly as the engine frames landscape (1152x768) output. Use this when displaying the avatar at a landscape aspect ratio. For avatars with legacy landscape source images this is the same as imageUrl.
Preview image cropped exactly as the engine frames portrait (768x1152) output. Use this when starting a session with portrait videoWidth/videoHeight. null when the avatar cannot render portrait output.
Signed URL for a muted 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.
Signed URL for a muted idling-loop MP4 of the avatar, if one exists. The URL expires after 1 hour; re-fetch the avatar to get a fresh URL. null when unavailable or still generating.
Timestamp when the avatar was created.
Timestamp when the avatar was last updated.
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.
Avatar models this avatar can be used with. Pass one of these values as avatarModel when creating a persona or starting a session.
Avatar model used by default when no explicit avatarModel is requested.
AI-generated description of the avatar's appearance, setting, and style. null if metadata generation has not completed.
Curated tags describing the avatar. Empty array if metadata generation has not completed.
Render style of the avatar. unknown covers custom avatars and avatars whose metadata has not yet been generated.
realistic, animated_3d, illustrated, unknown 
