Frequently asked questions
Pricing
What does a minute cost?
On your own hardware, Essence 2 and Expression 2 use 2 credits a minute; in our cloud, 4. At $1 per 100 credits that's about $0.02 and $0.04.
Can I pay yearly?
Yes. Annual plans bill twelve months of credits up front.
Can I cancel?
Cancel any time in the console; your plan runs to the end of the period. Upgrades apply at once, prorated. When you switch to a cheaper plan, credits you've already paid for stay in your balance.
Do credits roll over?
Top-ups are available on paid plans, Creator and up. Top-up credits are spent after plan credits. Credits you bought earlier stay usable on any plan. Plan credits come with each billing period.
Deployment & privacy
Can bitHuman run on the device?
Yes. Essence 2 and Expression 2 render on iPhone and iPad, Android (arm64), Mac, Linux and in browsers with WebGPU. Measured results for each device are published at docs.bithuman.ai/performance.
Does customer audio or video leave our network?
When the avatar renders on your hardware, its audio and video stay there. The conversation runs where you choose: the CLI's local conversation brain, your own speech and language services, or bitHuman's cloud voice service. With the first two, bitHuman receives usage metering only — never audio, video or conversation text. The local brain still signs in and reports usage online, so it needs a network connection; it is not part of the offline license. In the bitHuman cloud, and with the web embed, audio and conversation are processed by bitHuman and its service providers to run the session.
Does bitHuman train on our data?
Your photo is used to build your own avatar. If you need a written answer about model training for your organization, contact us.
Offline
Can bitHuman run without an internet connection?
Offline license is only available to Business and Enterprise clients who want to run real-time avatars completely locally, off the internet — e.g. kiosks, trade shows, ATM machines, embedded screens. Linux PCs and terminals; arranged through sales. Essence 1 runs fully offline on Linux (x86_64 and ARM64) today. Essence 2 offline comes later. Expression 2 runs fully offline on Linux x86_64 with an offline pack. Packs start at 100,000 credits. Other self-hosted and on-device sessions check in when they start and keep rendering through a network drop of up to 5 minutes.
Which operating systems can run an offline license?
Linux PCs and terminals (x86_64 and ARM64). Phones, Macs and browsers stay online: the Swift package, the Android SDK and the web embed check your credential when a session starts, and an on-device session keeps rendering through a network drop of up to 5 minutes. Essence 1 runs fully offline on Linux (x86_64 and ARM64) today. Essence 2 offline comes later. Expression 2 runs fully offline on Linux x86_64 with an offline pack. For Windows-based terminals, talk to us.
Building an app
How do I start building?
Get an API secret on the Creator plan, then install the Swift package, the Android SDK, the Python SDK or the web embed. Each has a quickstart in the docs.
Is there an iOS and Android SDK for bitHuman avatars?
Yes. The Swift package renders Essence 2 and Expression 2 on iPhone, iPad and Mac. essence2-android and expression2-android, from bitHuman's Maven repository (maven.bithuman.ai), render them on arm64 Android phones. Measured results for each device are published at docs.bithuman.ai/performance.
Does the avatar render on the phone or in the cloud?
With the Swift and Android SDKs, on the phone. With the web embed, in the bitHuman cloud by default, or in the browser tab with WebGPU (render=local), falling back to cloud rendering. With a LiveKit cloud avatar, in the bitHuman cloud.
Does the SDK include the voice and the AI conversation?
The Swift and Android SDKs only render: your app passes in 16 kHz speech and draws the frames. Use any speech recognition, language model and voice, or use bitHuman's managed agent through the web embed. On a Mac or a Linux PC, the bitHuman CLI's local conversation brain can run the whole conversation on the machine.
Can I use my own language model and persona?
Yes. Any OpenAI-compatible endpoint works. Set the persona in your model's system prompt or, for a managed agent, in its system_prompt.
Can I build an AI companion app with bitHuman?
Yes. bitHuman provides the companion's face, rendered in real time on the phone, on the Mac or in the browser, and you choose the voice, the language model and the persona. The companion guide in the docs walks through adding the SDK, the API secret, resampling speech, replies, interruption and closing the avatar with the screen.
What data does the SDK send to bitHuman?
Usage reports for metering, such as which session ran and for how long. They never contain audio, video, images or conversation text. The SDK also checks your API secret when a session starts. With the web embed, the conversation itself runs on bitHuman's servers.
Can I use bitHuman in a React or Next.js app?
Yes, with the iframe embed or the floating website widget. There is no npm package: the embed is an iframe in any framework, and the docs web page has a React snippet.
Avatars & models
Which model should I use?
Essence 2 for a photoreal person; Expression 2 for any character, from a person to an animal, a mascot or an object. Both render on the device, on your servers or in our cloud. Essence 1 and Expression 1 remain maintained first-generation models. Expression 1 is cloud-only.
What does it cost to make an avatar?
Creating your own avatar is a one-time 500 credits for Essence 2 (ready in a few minutes) or 2,000 credits for Expression 2 (it takes longer to build).
Where is an avatar made?
Creating an avatar from a portrait happens in the bitHuman cloud; the finished avatar then runs on your devices.
