Docs index: /llms.txt · every page as Markdown: add .md

‹ Overview

Pricing and credits

Every rate per model and platform, creation costs, plans and offline licensing.

Prices are in credits: 100 credits = $1, so 4 credits a minute is about $0.04 a minute. How billing works sets out what is billed and how. Everything bills against your API secret. To estimate a month or an app, use the estimate; your balance is on the Billing API.

How billing works

  • In the bitHuman cloud and in bitHuman Live, credits pay for active session time, talking or idle, by the exact second.
  • On your own devices or servers, online sessions with current versions of the Essence 2 and Expression 2 SDKs, the bitHuman Python SDK and the bitHuman CLI charge credits only for the seconds the character is speaking.
  • Talking videos: whole minutes of output, minimum one.
  • Rates: Essence 2 and Expression 2 use 2 credits a minute on the device or your servers and 4 credits a minute in the bitHuman cloud; a managed agent’s voice chat is 10 credits a minute, all-inclusive. Essence 1: 1 credit a minute on your own machine, 2 in the bitHuman cloud.
  • An offline pack is prepaid: you buy credits up front, and the machine uses them for active session time, talking or idle.
  • Using an older SDK version? Contact support.

Serving — credits per live minute

The first table is the avatar-only rate per model; the second is the all-inclusive managed-agent rate (both defined below the tables).

ModelCloudSelf-hosted and on-device
Essence 2 (essence-2)4 credits/min2 credits/min
Expression 2 (expression-2)4 credits/min2 credits/min
Essence 1 (essence-1)2 credits/min1 credit/min
Expression 1 (expression-1)4 credits/min—

A managed conversational agent bills one all-inclusive rate: it covers the avatar, whether it renders in the bitHuman cloud or in the viewer’s browser.

SurfaceRate
Managed voice chat (all-inclusive)10 credits/min
Managed voice chat, camera on (vision; replaces the voice chat rate)30 credits/min

An avatar-only session (your own agent through the plugin or the API) that renders in the viewer’s browser bills the model’s self-hosted rate above. Inside a managed agent’s chat the all-inclusive rate covers it.

How sessions in the bitHuman cloud are billed: active session time, talking or idle: exact seconds x rate / 60, rounded down per session with the remainder carried to your next session; no minimum.

Two ways to pay for a live avatar:

  • Avatar only: you bring the conversation (your own speech-to-text, language model and voice, through an SDK, the plugin or the API) and pay only the model’s rate in the first table.
  • Managed agent: bitHuman runs the whole conversation (listening, the replies, the voice) and the avatar, as in the web embed, for one all-inclusive rate in the second table.

A stopped or disconnected session accrues nothing.

On a phone or a Mac, a session ends on its own once its app has been in the background, or has asked for no frame, for 60 seconds, and is billed up to that point. This applies from Swift package 2.20.4, essence2-android 0.9.5, expression2-android 0.6.1 and Flutter plugin 2.6.37. File rendering (bithuman render, or render() in the Python SDK) bills the duration of the video it writes, at the self-hosted rate.

Expression 1 (expression-1) runs on NVIDIA GPUs in the bitHuman cloud.

One sessionIt startsa self-hosted or on-device session checks yourcredentialTalkingIdle, listeningThe network dropsrendering continues for up to 5 minutesIt endsbilling stopsBilling: see How billing works(https://docs.bithuman.ai/pricing#how-billing-works).
A session and what it bills. Billing: see How billing works (https://docs.bithuman.ai/pricing#how-billing-works). Online self-hosted and on-device sessions check your credential when they start and keep rendering through a network drop of up to 5 minutes.

Creation — one-time credits

ActionCredits
Create an agent: essence-1 or expression-1250
Create an agent: essence-2500
Create an agent: expression-22000
Create an agent: autothe routed model’s rate (500 or 2000)
Add a model to an agentthe same per-model rates; 0 for Expression 1
Generate gestures for an Essence 1 agent (Gestures)250

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).

A failed creation is refunded automatically. GET /v1/pricing returns this schedule as JSON; send your API secret in the api-secret header.

Talking video — per minute of output

Talking-video renders bill per minute of finished output, rounded up, minimum one minute. A failed render is refunded.

ModelPer minute of output
essence-24 credits
expression-24 credits
essence-12 credits
expression-14 credits

Plans

API and SDK use needs the Creator plan or higher: from 2026-10-19 (00:00 UTC) a Free account’s API secret is refused with 403 PLAN_REQUIRED. A Free account can try the sample avatars on bithuman.ai, but cannot create agents or buy credit top-ups. Every refusal and its fix: Plan and credit refusals. Choose a plan.

PlanMonthlyYearlyCredits / monthAgentsConcurrent cloud sessions
Free$0—99none: cannot create1
Creator$20$2042,00073
Pro$99$1,01012,0004010
Business$299$2,99050,00020050
Enterprise$999$9,990250,0001,000200
CustomContact sales—by agreementby agreementby agreement

Annual plans bill twelve months of credits up front. Switching to a cheaper plan takes effect at your next renewal: you keep your current plan’s credits until then.

  • Agents: a creation over your plan’s limit returns 403 AGENT_LIMIT_REACHED, with an upgrade_url. Existing agents keep working.
  • Concurrent sessions limit live cloud sessions; a session over the limit is refused with 403 CONCURRENCY_LIMIT_REACHED, with an upgrade_url (rate limits). Self-hosted and on-device sessions are limited only by credits.
  • Creation costs credits: a creation you cannot pay for returns 402 INSUFFICIENT_BALANCE, with a topup_url, and creates nothing.

Top-up credits

On the Creator plan or higher, top up any time at $1 = 100 credits. Top-up credits are spent after plan credits.

Connectivity

SituationWhat happens
No API secret, or a rejected one, at the startthe session does not start
No network when a session startsthe session does not start; retry when connected
The network drops after the session startedthe session continues for 5 minutes, then pauses until the connection returns; usage is reported when it does
Credits run outthe session stops at the next usage report; top up to continue

Offline licensing

Offline license is only available to Business and Enterprise clients who want to run realtime avatars completely locally, off the internet — e.g. kiosks, trade shows, ATM machines, embedded screens. Linux and macOS computers (Apple silicon); bought in the Console or through sales.

Packs start at 100,000 credits, metered on the machine at the self-hosted rate, with no required reconnection. Which models run offline on which computers, and the setup: Fully offline.

Contact sales to arrange an offline license.

What is not billed

  • Stopped or disconnected sessions.
  • API secrets, SDK installs and model downloads.
  • Failed creations and renders (refunded) and failed authentication.

Next

This section moved: docs.bithuman.ai/pricing/estimate#estimate-a-month

This section moved: docs.bithuman.ai/pricing/estimate#budget-an-app

This section moved: docs.bithuman.ai/api/billing#check-credit-balance