Web embed

One URL in an <iframe>: no npm package, no install and no secret in the browser.

Before you start

The embed URL is https://www.bithuman.ai/embed/<CODE>, and the avatar listens and answers. render=auto: web render by default; devices that can’t web-render use cloud render automatically. render=cloud forces cloud. render=local requests rendering in the visitor’s tab only, after a device check.

• A current browser. In-tab rendering needs a supported graphics path and a passing device check.
• An agent code: A23WJF0199 (the wise-pup sample avatar) or your own (create your own avatar).
• For a private agent, an embed token minted by your server.

Authenticate

A public agent needs no credential. For a private agent, your server mints an embed token with your API secret and passes it to the page. Sessions on your own agent bill your account per second, voice and AI included (pricing).

Run your first avatar

<!doctype html>
<html>
  <body style="margin:0">
    <iframe src="https://www.bithuman.ai/embed/A23WJF0199?render=auto"
            allow="microphone *" style="width:100%;height:100vh;border:0"></iframe>
  </body>
</html>

Expected: the avatar’s picture with Tap to talk. Select it, allow the microphone, and the avatar greets you and answers when you speak. Keep the * in allow, or the microphone is blocked. To try it without a page, open https://www.bithuman.ai/embed/A23WJF0199.

The wise-pup sample ends each session after 1 minute. For your site, embed your own agent (create your own avatar); by default its visitors can talk for as long as they like; you can set a per-session and a daily limit (visitor limits, in the Console).

Play with sound (20 seconds, captions)

Performance

Measured in the tab with WebGPU, in Chrome on an Apple M4.