Create Avatars

With the Dashboard
With Code

Don't have an account yet?

Follow the setup guide to create your Equos account and organization.

Go to the Avatars page

Open the avatar builder page: studio.equos.ai/avatars/new

Fill in the avatar form

Enter a the name of the avatar.
Describe how you want your avatar to look like.
Click the magic wand to generate an avatar image based on your description.

Alternatively, you can drag & drop your own image.

For the best quality:

use a clear headshot with a neutral background.
ensure the image is centered around the face.
ensure the image is well-lit.
ensure the face is large enough and entirely visible.
ensure there is space around the head.
ensure the image is photorealistic (e.g. not a cartoon).
use a high-resolution image (we recommend 1024x1024 pixels).

Copy the avatar ID

Once created, your avatar will appear in the list.
Copy the Avatar ID—you’ll need it for API calls and when testing in the playground.

GOOD Examples

These images follow good practices for avatar creation:

—

BAD examples:

These images do not follow good practices for avatar creation (and will likely lead to poor results, or won’t be accepted at all):

Don't have an API key yet?

Follow this guide to create an API key.

You can either use our REST API or our official SDKs (NodeJS, Python) to create avatars programmatically.

Create Avatar

   import { Equos, type EquosAvatar } from "@equos/node-sdk";
   
   const client = Equos.client(process.env.EQUOS_API_KEY!);

   const avatar: EquosAvatar = await client.avatars.create({
       name: "Jeremy",
       identity: "equos-avatar-jeremy",
       refImage: "data:image/jpeg;base64,<image as base64 data url>",
   });

   console.log("Avatar ID:", avatar.id);

See the Avatar Creation Endpoint in the API Reference for all available options and samples in other languages.

For the best quality:

use a clear headshot with a neutral background.
ensure the image is centered around the face.
ensure the image is well-lit.
ensure the face is large enough and entirely visible.
ensure there is space around the head.
ensure the image is photorealistic (e.g. not a cartoon).
use a high-resolution image (we recommend 1024x1024 pixels).

Getting started

Recipes

SDKs

Integrations

Don't have an account yet?

Don't have an API key yet?