跳转到主要内容

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.

阿里云百炼(DashScope / Model Studio)是 Mirobody 中国集群推荐的 LLM 后端。它聚合了阿里自研 Qwen 系列、第三方 DeepSeek / Kimi / GLM / MiniMax,以及嵌入、reranker,全部走同一个 API Key。

1. 注册并拿 Key

1

开通百炼

登录 阿里云百炼控制台。新账号会自动开通,部分模型需要先开通付费。
2

创建 API Key

API Key 管理 创建一个 key,复制保存——key 仅显示一次。
3

确认计费状态

计费管理 启用对应模型的付费订阅;部分新模型有免费额度。

2. 端点信息

DashScope 同时提供原生协议与 OpenAI 兼容协议。Mirobody 走的是 DashScope 原生协议,您只需把 API Key 通过 BYOK header 传入即可,无需关心 base URL。
项目
OpenAI 兼容 base URL(参考)https://dashscope.aliyuncs.com/compatible-mode/v1
DashScope 原生 base URL(Mirobody 用)https://dashscope.aliyuncs.com/api/v1
认证方式Authorization: Bearer <DASHSCOPE_API_KEY>
海外区域杭州(默认)· 弗吉尼亚 · 新加坡 · 法兰克福

3. 可调用模型

下表是百炼当前主推的模型,Mirobody /api/chatprovider 字段决定调哪一个。完整最新列表以 百炼模型列表 为准。

文本生成

Mirobody provider底层 model id适用场景
DeepSeekFlashdeepseek-v4-flash默认首选,响应快、成本低
DeepSeekProdeepseek-v4-pro复杂推理、医学解读
kimikimi-k2.6长上下文、长文档解读
minimaxMiniMax-M2.7中文表达自然
—(百炼直调)qwen3.7-maxQwen 旗舰款,超长任务链
—(百炼直调)qwen3.6-plus性能 / 速度 / 成本平衡,官方推荐通用款
—(百炼直调)qwen3.6-flash高吞吐、低延迟
—(百炼直调)glm-5.1智谱 GLM
—(百炼直调)mimo-v2.5-pro小米 MiMo

嵌入与 Rerank

模型用途
text-embedding-v4文本嵌入
tongyi-embedding-vision-plus多模态嵌入
qwen3-rerankreranker

4. 在 Mirobody 请求中使用

curl -N -X POST https://mcp.thetahealth.cn/api/chat \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-LLM-Provider: dashscope" \
  -H "X-LLM-Api-Key: sk-xxx-from-dashscope" \
  -H "Content-Type: application/json" \
  -d '{"question":"你好","agent":"App","provider":"DeepSeekFlash"}'

故障排查

  • 上游返回 InvalidApiKey → 检查百炼控制台 key 是否启用、是否已订阅对应模型。
  • 上游返回 Throttling.User → DashScope 侧 RPM/TPM 限流,到 API Key 用量 调整额度。
  • 模型 ID 找不到 → 部分新模型需要先在控制台”模型广场”申请开通。
  • 网络无需 VPN → DashScope 国内直连。