> ## Documentation Index
> Fetch the complete documentation index at: https://docs.mirobody.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# 快速开始
> 在控制台创建密钥，发起第一次 /v1 调用。
Mirobody 托管 API **兼容 OpenAI**：把任意 OpenAI SDK 指向 `https://test-mirobody-api.thetahealth.ai/v1`，带上 `mb_live_*` 密钥，智能体即可基于每个终端用户的真实健康数据作答。
账户管理——**API 密钥、用量、在线 Playground**——都在开发者控制台 [**test-platform.mirobody.ai**](https://test-platform.mirobody.ai/)。本文档是参考与指引；控制台才是你登录与管理一切的地方。
**今日可用：**面向全球 **test** 集群开发——API `https://test-mirobody-api.thetahealth.ai/v1`，控制台 [test-platform.mirobody.ai](https://test-platform.mirobody.ai/)。生产集群正在开通中；中国**测试**环境现也已上线（[区域](/zh/api-reference/regions/overview)）。控制台默认中文——用右上角的语言切换可切到英文。
用**邮箱验证码**登录控制台——输入邮箱，收取 6 位验证码，即可登录。然后打开 **API Keys** 创建一个密钥；明文只显示**一次**。（需要评估账户？发邮件给 [Mirobody 支持](mailto:developer@thetahealth.ai)。）
登录、创建 `mb_live_*` 密钥并复制。
```bash theme={null}
export MIROBODY_API_KEY="mb_live_..."
```
```bash curl theme={null}
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"
}'
```
```python Python (OpenAI SDK) theme={null}
from openai import OpenAI
client = OpenAI(api_key="$MIROBODY_API_KEY", base_url="https://test-mirobody-api.thetahealth.ai/v1")
resp = client.chat.completions.create(
model="mirobody-flash",
messages=[{"role": "user", "content": "我的空腹血糖趋势如何？"}],
user="alice",
)
print(resp.choices[0].message.content)
```
```javascript Node.js (OpenAI SDK) theme={null}
import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MIROBODY_API_KEY,
baseURL: "https://test-mirobody-api.thetahealth.ai/v1",
});
const resp = await client.chat.completions.create({
model: "mirobody-flash",
messages: [{ role: "user", content: "我的空腹血糖趋势如何？" }],
user: "alice",
});
console.log(resp.choices[0].message.content);
```
`user` 字段把每个终端用户隔离为一个 [Subject](/zh/api-reference/overview#多租户：user-字段)——传入各自稳定的 id 即可。完整说明见 [对话参考](/zh/api-reference/chat)。
新建的 Subject 没有数据，智能体会如实说明。先写一条记录（或用 [`POST /v1/files`](/zh/api-reference/files) 上传一份报告），再问一次：
```bash theme={null}
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`。详见 [数据](/zh/api-reference/data) 与 [文件](/zh/api-reference/files)。
## 不想敲 curl？
控制台自带 **Playground**——在浏览器里跑对话、上传文件、查看工具步骤，无需写代码。
在浏览器里基于你的账户试用智能体。
请求数、tokens、费用。
## 在线体验
**chat.mirobody.ai** —— 旗舰 C 端产品，与本 API 同一套引擎。
创建 `mb_live_*` 密钥、查看用量、试用 Playground。
## 下一步
鉴权、多租户、留存，以及每个 `/v1` 端点。
curl / Python / Node，流式与文件上传。
Base URL、数据驻留、模型与限额。
PIPL / 数据驻留；申请 DPA。