POST
/
api
/
v1
/
avatars
Create an avatar
const options = {
  method: 'POST',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({displayName: '<string>'})
};

fetch('https://realtimeavatar.ai/api/v1/avatars', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));
{
  "id": "<string>",
  "tenantId": "<string>",
  "displayName": "<string>",
  "modelId": "<string>",
  "createdAt": "<string>",
  "updatedAt": "<string>",
  "sourceAssetId": "<string>",
  "defaultVoiceId": "<string>",
  "cacheManifestId": "<string>",
  "cacheVersion": 1
}

Authorizations

​
Authorization
string
header
required

TIC API key as a bearer token: Authorization: Bearer tic_live_... or tic_test_.... Create keys in the dashboard at /platform/dashboard or via POST /api/v1/api-keys.

Body

application/json
​
displayName
string
required
Required string length: 1 - 160
​
sourceKind
enum<string>
required
Available options:
image,
video
​
modelId
string

Avatar model id; defaults to the platform default model.

​
sourceAssetId
string

Asset id from POST /api/v1/assets or /api/v1/assets/remote.

​
defaultVoiceId
string
Required string length: 8 - 160
​
settings
object
​
metadata
object

Response

Avatar created

​
id
string
required

Platform avatar id (ava_...). Use this in realtime prepare/turn calls.

​
tenantId
string
required
​
displayName
string
required
​
sourceKind
enum<string>
required
Available options:
image,
video
​
modelId
string
required
​
status
enum<string>
required
Available options:
draft,
preprocessing,
ready,
failed,
disabled,
deleted
​
createdAt
string
required
​
updatedAt
string
required
​
sourceAssetId
string | null
​
defaultVoiceId
string | null
​
cacheManifestId
string | null
​
cacheVersion
integer
Required range: x >= 0