快速开始

讯蒙智能云是面向开发者的蒙古语 AI 能力开放平台，提供文本翻译、图片翻译、文档翻译、网页翻译、语音翻译、语音合成、语音识别、词典查询、编码转换、术语库、口语发音评测、Tengri 大模型与向量嵌入共 13 项能力。

平台能力分两类接入形态，密钥与计费相互独立：

本文带你完成从注册到首次调用的全部步骤。

第一步：注册并开通云账户

1. 访问 cloud.heimori.cn 并注册账号（已有蒙语学习通/黑森林账号可直接登录）。
2. 进入控制台，首次进入自动开通云账户，无需申请。
3. （可选）在「企业认证」提交营业执照完成认证，认证后可申请增值税发票与更高限额。

第二步：创建 API Key

1. 打开控制台「API 密钥」页，点击创建密钥。
2. 填写密钥名称，按需选择可访问的产品范围（不选默认可访问全部产品）与限流参数。
3. 创建成功后即可获得完整密钥（形如 sk-heimori- 开头的一串字符）；之后也可以随时在「API 密钥」列表中查看和复制完整密钥。

安全提醒：API Key 等同于账户的付费凭证。请只在服务端保存和使用，不要写入前端代码、App 安装包或公开代码仓库；发现泄露立即在控制台禁用或删除该密钥并更换新密钥。

第三步：发起首次调用

以文本翻译为例（中文 → 传统蒙古文）：

curl -X POST "https://cloud.heimori.cn/v1/translate/text" \
  -H "Authorization: Bearer sk-heimori-..." \
  -H "Content-Type: application/json" \
  -d '{
    "text": "你好，世界",
    "sourceLang": "zh",
    "targetLang": "mw"
  }'

把 sk-heimori-... 替换为你的完整密钥。调用成功返回 JSON 结果；每次响应都带 X-Request-Id 头，排障与联系支持时请提供该 ID。请求参数与响应结构以各产品文档页下方的「API 参考」为准，其中每个接口都附带 curl / Python / JavaScript 可运行示例。

使用 Tengri 大模型 / 向量嵌入（AI 产品）

AI 产品使用独立的 Tengri AI 配额，需要单独开通（一次即可）：

1. 打开控制台「Tengri AI」区，选择一键开通（自动创建 AI 账号，用户名沿用你的智能云手机号/邮箱），或绑定已有账号。
2. 在「Tengri AI → API 令牌」创建令牌（sk- 开头，注意区别于 sk-heimori- 密钥）。
3. 用 OpenAI 兼容协议调用（model 取当前上架的模型名，见官网「Tengri AI 模型价格」）：

curl https://platform.heimori.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tengri-2",
    "messages": [{"role": "user", "content": "你好"}]
  }'

已有 OpenAI SDK 的应用把 base_url 改为 https://platform.heimori.cn/v1、api_key 换成 Tengri AI 令牌即可，无需修改任何业务代码。

第四步：查看用量与费用

• 控制台「用量统计」：按产品/密钥/日期查看智能云产品的调用量与消费金额。
• 控制台「费用中心」：查看智能云余额、流水与月账单，并可充值与设置余额告警。
• 控制台「Tengri AI」区：查看 AI 配额、令牌用量明细，并为 AI 配额充值（同样支持开发票）。

下一步

• 阅读「鉴权与安全」了解两套凭证的使用规范与错误响应格式。
• 阅读「语种与语言代码」确认目标语种该填哪个代码（传统蒙古文 mw 与西里尔蒙古文 xle_mw 最易混淆）。
• 阅读「计费与免费额度」了解价格、免费额度与 AI 配额规则。
• 在「接口索引」按产品找到目标接口，点进产品文档查看完整参数与多语言代码示例。