跳转到主要内容
Mirobody 托管 API 兼容 OpenAI：把任意 OpenAI SDK 指向 https://test-mirobody-api.thetahealth.ai/v1，带上 mb_live_* 密钥，智能体即可基于每个终端用户的真实健康数据作答。
账户管理——API 密钥、用量、在线 Playground——都在开发者控制台 test-platform.mirobody.ai。本文档是参考与指引；控制台才是你登录与管理一切的地方。
今日可用：面向全球 test 集群开发——API https://test-mirobody-api.thetahealth.ai/v1，控制台 test-platform.mirobody.ai。生产集群正在开通中；中国测试环境现也已上线（区域）。控制台默认中文——用右上角的语言切换可切到英文。
1

登录并获取 API 密钥

用邮箱验证码登录控制台——输入邮箱，收取 6 位验证码，即可登录。然后打开 API Keys 创建一个密钥；明文只显示一次。（需要评估账户？发邮件给 Mirobody 支持。）

打开控制台 → API 密钥

登录、创建 mb_live_* 密钥并复制。
export MIROBODY_API_KEY="mb_live_..."
2

发起第一次调用

curl https://test-mirobody-api.thetahealth.ai/v1/chat/completions \
  -H "Authorization: Bearer $MIROBODY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "mirobody-flash",
        "messages": [{"role": "user", "content": "我的空腹血糖趋势如何？"}],
        "user": "alice"
      }'
user 字段把每个终端用户隔离为一个 Subject——传入各自稳定的 id 即可。完整说明见 对话参考。
3

给这个 Subject 写点数据

新建的 Subject 没有数据，智能体会如实说明。先写一条记录（或用 POST /v1/files 上传一份报告），再问一次：
curl https://test-mirobody-api.thetahealth.ai/v1/data \
  -H "Authorization: Bearer $MIROBODY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
        "user": "alice",
        "retention": "permanent",
        "records": [{"indicator": "fasting_glucose", "value": 5.4, "unit": "mmol/L", "time": "2026-06-16T07:30:00Z"}]
      }'
POST /v1/data 必须传 retention（无默认值）——省略会返回 400。详见 数据 与 文件。

​
不想敲 curl？

控制台自带 Playground——在浏览器里跑对话、上传文件、查看工具步骤，无需写代码。

Playground

在浏览器里基于你的账户试用智能体。

用量

请求数、tokens、费用。

​
在线体验

Mirobody 应用

chat.mirobody.ai —— 旗舰 C 端产品，与本 API 同一套引擎。

开发者控制台

创建 mb_live_* 密钥、查看用量、试用 Playground。

​
下一步

API 参考

鉴权、多租户、留存，以及每个 /v1 端点。

SDK 示例

curl / Python / Node，流式与文件上传。

中国区域

Base URL、数据驻留、模型与限额。

合规

PIPL / 数据驻留；申请 DPA。