产品文档

Tengri 大模型

更新于 2026-09-04

Tengri 系列大模型对话补全（Chat Completions）接口，OpenAI 兼容协议，支持流式输出与图片/音频/视频多模态理解。

能力与场景

Tengri 大模型提供多档对话补全能力，对传统蒙古文、西里尔蒙古文的阅读与生成，以及藏文、维吾尔文等民族语种做过专项优化。接口协议与 OpenAI 完全兼容：已有 OpenAI SDK 的应用把 base_url 改为 https://platform.heimori.cn/v1、api_key 换成 Tengri AI 令牌（sk- 开头，控制台「Tengri AI → API 令牌」创建）即可接入。除文本外还支持多模态理解：user 消息的 content 传分段数组即可携带图片、音频、视频。典型场景：蒙古语智能客服、写作助手、文化知识问答、图片/音视频内容理解、Agent 应用的民族语言底座。

端点列表

方法路径说明
POST/v1/chat/completions对话补全（OpenAI 兼容，支持 stream 流式与图片/音频/视频理解）

每个端点的请求参数、响应结构与可运行代码示例见本页下方「API 参考」（随接口定义自动生成，始终与线上一致）。

调用要点

  • 基址与鉴权与其他产品不同：基址 https://platform.heimori.cn/v1，令牌为 sk- 开头的 Tengri AI 令牌（不是 sk-heimori- 密钥）；首次使用请在控制台「Tengri AI」区一键开通或绑定已有账号。
  • 模型选型：Tengri 2 系列民族语种能力最强，T1 系列主打响应速度与性价比；当前上架的模型清单与实时价格见官网「Tengri AI 模型价格」（以该页为准，本文不再逐一罗列）。
  • 多模态：user 消息 content 传分段数组——text、image_url（http(s) 地址或 data URL）、input_audio（base64）、input_video（base64）。
  • 请求体传 stream: true 时以 SSE 流式返回增量内容，以 data: [DONE] 结束；非流式一次性返回完整结果。
  • 多轮对话请自行携带历史 messages；上下文长度上限以模型说明为准。
  • 错误响应为 OpenAI 风格（{ error: { message, type } }），与本站 sk-heimori- 系产品的错误结构不同。
  • 按 token 用量从 AI 配额实时扣费（输入与输出单价随模型不同），响应 usage 字段返回本次消耗明细（含图文音视频 token 细分）。

支持语种

  • 没有语种参数：模型直接理解与生成多语文本，对传统蒙古文、西里尔蒙古文、藏文、维吾尔文等民族语种做过专项优化。
  • 需要固定输出语种时在提示词中说明即可。

完整代码表与各产品对照见「语种与语言代码」。

计费

  • 本产品使用独立的 Tengri AI 配额（与智能云余额互不相通）。
  • 按 token 用量计费，各模型输入/输出单价不同，当前上架模型与实时价格见官网「Tengri AI 模型价格」或控制台「Tengri AI」区。
  • token 用量 = 输入 token + 输出 token，响应 usage 字段返回明细（含图片/音频/视频 token 细分）。
  • 充值入口在控制台「Tengri AI → 充值」，支持开具发票。

当前价格

按模型 token 单价从独立的 Tengri AI 配额扣减，各模型价格见Tengri AI 模型价格。

API 参考

本产品共 1 个接口，以下内容随接口定义自动生成。 需要跨产品查找接口时可前往接口索引。

创建对话补全（OpenAI 兼容 · Tengri AI）

POSThttps://platform.heimori.cn/v1/chat/completions

Tengri 大模型对话补全，协议与 OpenAI chat/completions 完全兼容。

基址与鉴权与其他产品不同：基址为 https://platform.heimori.cn/v1， Authorization: Bearer <Tengri AI 令牌>（sk- 开头，在控制台「Tengri AI → API 令牌」创建，不是 sk-heimori- 密钥）。

已有 OpenAI SDK 的应用仅需替换 base_url 与 api_key 即可接入。

模型（实时价格见官网「Tengri AI 模型价格」）：tengri-2 / tengri-2-fast / tengri-2-pro / tengri-t1 / tengri-t1-pro

多模态理解：Tengri 系列支持图片 / 音频 / 视频输入——user 消息的 content 传分段数组， 分段类型与结构：

分段 type结构说明
text{ "type": "text", "text": "..." }文本
image_url{ "type": "image_url", "image_url": { "url": "..." } }图片，url 支持 http(s) 地址或 data:image/...;base64, data URL
input_audio{ "type": "input_audio", "input_audio": { "data": "<base64>", "format": "mp3" } }音频（base64），format 如 mp3 / wav
input_video{ "type": "input_video", "input_video": { "data": "<base64>", "format": "mp4" } }视频（base64），format 如 mp4

流式：请求体 stream: true 时以 SSE 返回 chat.completion.chunk 增量，以 data: [DONE] 结束； 每个 chunk 的 choices[0].delta.content 为本次增量文本，最后一个数据 chunk 携带 usage 明细。

计费：按 token 用量从 Tengri AI 配额实时扣减（输入与输出价格随模型不同），响应 usage 字段返回明细（含图文音视频 token 细分）。

请求参数application/json

参数类型说明
model必填
string模型名，当前可选：tengri-2 / tengri-2-fast / tengri-2-pro / tengri-t1 / tengri-t1-pro
可选值：tengri-2tengri-2-fasttengri-2-protengri-t1tengri-t1-pro
示例：tengri-2
messages必填
array<object>对话消息列表（多轮对话自行携带历史）。user 消息的 content 可为字符串，或分段数组以携带图片/音频/视频
示例：[{"role":"system","content":"You are a helpful assistant."},{"role":"user","content":"介绍一下传统蒙古文的书写方向。"}]
└role必填
string
可选值：systemuserassistant
└content必填
string字符串，或分段数组：{type:'text',text} | {type:'image_url',image_url:{url}} | {type:'input_audio',input_audio:{data,format}} | {type:'input_video',input_video:{data,format}}
stream可选
booleantrue 时以 SSE 流式返回增量内容，以 data: [DONE] 结束
默认值：false
temperature可选
number采样温度（越高越发散）
top_p可选
number
max_tokens可选
integer限制本次回复的最大输出 token 数

响应示例200 · application/json

200 响应
{
  "id": "chatcmpl-2026…",
  "object": "chat.completion",
  "created": 1788150480,
  "model": "tengri-2",
  "choices": [
    {
      "index": 0,
      "message": {
        "role": "assistant",
        "content": "传统蒙古文自上而下书写、列从左向右排列，是世界上少数仍在使用的竖排文字之一……"
      },
      "finish_reason": "stop"
    }
  ],
  "usage": {
    "prompt_tokens": 29,
    "completion_tokens": 64,
    "total_tokens": 93,
    "prompt_tokens_details": {
      "cached_tokens": 0,
      "text_tokens": 29,
      "audio_tokens": 0,
      "image_tokens": 0
    }
  }
}

代码示例

curl https://platform.heimori.cn/v1/chat/completions \
  -H "Authorization: Bearer sk-..." \
  -H "Content-Type: application/json" \
  -d '{
    "model": "tengri-2",
    "messages": [
      {"role": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "介绍一下传统蒙古文的书写方向。"}
    ]
  }'