Create your own avatar

4 steps

1. 1. Choose a model

   You have	Use
   A photo of a real person	essence-2: photoreal, up to 1080p
   A character, animal, robot or illustration	expression-2: any subject
   Not sure	auto: people go to essence-2, everything else to expression-2

   Every model except Expression 2 needs a clear, real human face: see Choosing a model.

   Expected

   One model value: essence-2, expression-2 or auto.

   Done: step 1

2. 2. Pick the inputs

   Input	Use for	Limits
   Image	the face	under 10 MB; one clear figure, neutral expression, facing the camera, face unobstructed
   Voice	voice cloning	30 seconds or more of clean speech, one speaker, no music (MP3, WAV or M4A); the whole file is used
   Prompt	the personality	required when there is no image

   What makes a good photo

   One subject, in focus, facing the camera with a resting expression and the whole face visible (eyes, nose and mouth). The photo is checked before anything is charged; the refusals are in Troubleshooting. For an animal or character, use expression-2 with a well-lit, front-facing photo and the face filling the frame.

   Without a voice sample, a voice is generated to match the persona. Without a prompt, a persona is generated from the image.

   Expected

   An image URL that opens in a browser without signing in, under 10 MB, plus a voice sample and a prompt if you have them.

   Done: step 2

3. 3. Create the agent

   curl -X POST https://api.bithuman.ai/v1/agent/generate \
     -H "Content-Type: application/json" -H "api-secret: $BITHUMAN_API_SECRET" \
     -d '{"model": "auto", "prompt": "You are a friendly receptionist.", "image": "https://example.com/headshot.jpg"}'

   The response carries an agent_id. Creation takes about 2–2.5 hours for the second-generation models. You can also create an agent in the dashboard at bithuman.ai, which starts on Expression 2.

   Expected

   {"success": true, "message": "Agent generation started", "agent_id": "A80HVD8577", "status": "processing"}

   Done: step 3

4. 4. Wait until it is ready

   Poll GET /v1/agent/status/{agent_id} every few seconds until status is ready or failed.

   Expected

   status is ready: after about 2 to 2.5 hours, or up to 4 for an Expression 2 identity that needs more training.

   Done: step 4

All steps done.