Options for configuring an AvatarSession.

interface AvatarSessionOptions {
    apiKey?: string;
    apiUrl?: string;
    avatarParticipantIdentity?: string;
    avatarParticipantName?: string;
    connOptions?: APIConnectOptions;
    personaId?: string;
    replicaId?: string;
}

Properties

apiKey?: string

Tavus API key. Falls back to TAVUS_API_KEY.

apiUrl?: string

Override the Tavus API base URL.

avatarParticipantIdentity?: string

Identity for the avatar participant. Defaults to tavus-avatar-agent.

avatarParticipantName?: string

Display name for the avatar participant. Defaults to tavus-avatar-agent.

connOptions?: APIConnectOptions

API retry/timeout options.

personaId?: string

Tavus persona id. Falls back to TAVUS_PERSONA_ID; created automatically when omitted.

replicaId?: string

Tavus replica id. Falls back to TAVUS_REPLICA_ID.