bitHuman docs

npx add-mcp 'https://docs.bithuman.ai/docs-mcp'

Para agentes de IA

URL: https://docs.bithuman.ai/resources/agents

Tudo o que um agente de IA precisa para ler estes documentos e criar com bitHuman.

Tudo neste site está disponível em um formato que um agente pode ler sem precisar analisar HTML.

Crie com um agente de codificação

Cole isto no Claude Code, Cursor, Codex ou outro agente de codificação, com seu projeto aberto:

Read https://docs.bithuman.ai/llms.txt and add a bitHuman avatar to this project: <what you are
building, for example "an iPhone app where a cartoon fox answers questions">. Pick essence-2 for a
real person or expression-2 for any other character, start from the matching example in
https://gitlab.com/bithuman/sdk/bithuman-examples (its llms.txt lists them), and read my API secret
from BITHUMAN_API_SECRET. Never print it, put it on a command line or commit it.

Você precisa de um segredo de API no plano Creator ou superior: inscreva-se e depois escolha um plano. Para melhores resultados, também forneça ao agente o servidor MCP de documentação e a habilidade de agente abaixo.

Markdown para cada página

• Adicione .md à URL de qualquer página: /platforms/python.md. Cada página HTML vincula sua versão gêmea com rel="alternate".
• Ou solicite markdown: uma requisição com Accept: text/markdown obtém o mesmo texto na URL da própria página.

curl -H "Accept: text/markdown" https://docs.bithuman.ai/platforms/python

Arquivos

Arquivo	O que contém
/llms.txt	O índice: regras para agentes, onde cada modelo roda, fatos-chave, um comando por plataforma, velocidade e links
/llms-full.txt	Introdução, as páginas de plataforma Python, CLI, Windows, LiveKit, Pipecat e REST, e a API REST em um único arquivo
/llms/start.txt, /llms/platforms.txt, /llms/apps.txt (iOS e iPadOS, macOS, Android, Flutter, Web), /llms/deploy.txt, /llms/models.txt, /llms/build.txt, /llms/api.txt	O mesmo texto, uma seção por vez
/api/openapi.yaml	A API REST como OpenAPI 3
/versions.json	A versão atual e a linha de instalação de cada artefato
/platforms.json	Todas as formas de executar bitHuman, com o primeiro comando e documentação
/performance.json	A velocidade de cada configuração publicada (× tempo real), com hardware, versão e data
/changelog.xml	Cada versão como um feed RSS, marcado por plataforma
Showcase	Avatares de exemplo que qualquer pessoa pode usar: slug, código do agente, modelo

MCP de documentação

A documentação também é um servidor MCP com duas ferramentas somente leitura: search encontra páginas, e fetch retorna uma como markdown. Não exige conta nem chave.

Cliente	Como adicionar
Claude (claude.ai, desktop)	adicione bitHuman docs no Diretório de Conectores
Claude Code	claude mcp add --transport http bithuman-docs https://docs.bithuman.ai/docs-mcp
Cursor	Adicionar ao Cursor (abre o Cursor), ou adicione o JSON abaixo em ~/.cursor/mcp.json
VS Code	Adicionar ao VS Code (abre o VS Code), ou code --add-mcp '{"name":"bithuman-docs","type":"http","url":"https://docs.bithuman.ai/docs-mcp"}'
Outros clientes	um servidor remoto (Streamable HTTP) em https://docs.bithuman.ai/docs-mcp

{ "mcpServers": { "bithuman-docs": { "url": "https://docs.bithuman.ai/docs-mcp" } } }

Também está no Registro Oficial de MCP como ai.bithuman/docs.

Para controlar o próprio bitHuman (criar agentes, renderizar vídeos) a partir de um cliente MCP, use o servidor da própria CLI: servidor MCP. Para que os personagens do bitHuman falem dentro do ChatGPT ou Claude, adicione o servidor hospedado https://mcp.bithuman.ai/mcp (como).

Habilidade de agente

bithuman-integrate é uma habilidade que um agente carrega antes de adicionar um avatar a um projeto: ela escolhe o caminho, instala, conecta fala de 16 kHz aos quadros e lida com o segredo da API. Salve como .claude/skills/bithuman-integrate/SKILL.md em um projeto, ou ~/.claude/skills/bithuman-integrate/SKILL.md para todos os projetos:

mkdir -p .claude/skills/bithuman-integrate
curl -fsSL https://docs.bithuman.ai/skills/bithuman-integrate/SKILL.md -o .claude/skills/bithuman-integrate/SKILL.md

Regras para agentes

1. Envie model ("essence-2" ou "expression-2") em cada agente que você criar, e faça polling até status ser ready ou failed.
2. O uso de API e SDK exige o plano Creator ou superior.
3. Leia o segredo da API do ambiente (BITHUMAN_API_SECRET); nunca o escreva em código ou linha de comando. Em um worker do LiveKit, o segredo é lido como BITHUMAN_MASTER_SECRET (o mesmo segredo com outro nome, para que o plugin nunca o copie para a sala) e o plugin recebe um token cunhado (LiveKit).
4. Ao explicar, diga onde o avatar renderiza e onde a conversa roda: o avatar renderiza (dispositivo, navegador, servidor, nuvem); a conversa roda (sua stack, o cérebro de conversa local da CLI ou os servidores do bitHuman).
5. Obtenha versões de /versions.json, velocidade de /performance.json e preços de GET https://api.bithuman.ai/v1/pricing (envie o cabeçalho api-secret; sem ele, a chamada retorna 401), e não da memória ou de um exemplo antigo.

Próximos passos

• Servidor MCP (a CLI) · Início rápido · Referência da API