Get your API secret
Bring AI avatars into your own app with the bitHuman Python SDK or REST API. Included from the Creator plan up.
Your API secrets
Create and manage API secrets in your developer dashboard.
- 1
Create an account
Sign up in seconds.
- 2
Choose Creator or higher
The API and SDKs start at Creator.
- 3
Open the developer dashboard
Head to the Developer section of your dashboard.
- 4
Generate an API secret
Create a named secret and copy it. Treat it like a password.
- 5
Build
Use it as the api-secret header (REST) or BITHUMAN_API_SECRET env var (SDK/CLI).
Quickstart
Python SDK
pip install bithuman
export BITHUMAN_API_SECRET="<your API secret>"
python - <<'PY'
import bithuman
bithuman.open("agent.imx").render("speech.wav", out_mp4="out.mp4")
PYCLI — a separate binary, not on PyPI
curl -fsSL https://install.bithuman.ai | sh export PATH="$HOME/.local/bin:$PATH" bithuman login bithuman render agent.imx speech.wav -o out.mp4
REST API
curl -X POST https://api.bithuman.ai/v1/validate \ -H "api-secret: $BITHUMAN_API_SECRET"
Docs
Guides, concepts, and API reference.
Python SDK
pip install bithuman — avatars on macOS and Linux.
REST API
Call api.bithuman.ai from any language.