计算输入 Token 数¶

计算 Messages 请求的输入 Token 数，不生成回复。

POST https://token.moi.matrixorigin.cn/v1/messages/count_tokens

调用前准备¶

准备用于 Genesis 调用的个人访问令牌或服务账号 API Key。创建和权限配置参阅管理 Genesis 访问凭据。
通过查询可调用模型选择支持 Messages 的模型。

请求体¶

将示例中的 $GENESIS_ACCESS_TOKEN 和 $MODEL_ID 分别替换为访问凭据和所选模型的 ID。

输入示例

curl -X POST \
  "https://token.moi.matrixorigin.cn/v1/messages/count_tokens" \
  -H "Authorization: Bearer $GENESIS_ACCESS_TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
  "model": "'"$MODEL_ID"'",
  "messages": [
    {
      "role": "user",
      "content": [
        {
          "type": "text",
          "text": "Reply with OK."
        }
      ]
    }
  ]
}'

参数说明

以下字段覆盖文本消息；计数请求不需要设置输出 Token 上限。

参数	类型	是否必填	说明
`model`	string	是	所选模型的 ID，取自模型查询结果中的 `data[].id`。
`messages`	array of object	是	按对话顺序排列的非空消息列表。
`messages[].role`	string	是	消息角色，文本对话使用 `user` 或 `assistant`。
`messages[].content`	string 或 array of object	是	文本内容或文本块列表。
`messages[].content[].type`	string	文本块中必填	文本块填写 `text`。
`messages[].content[].text`	string	文本块中必填	非空文本内容。

成功响应¶

成功时返回消息输入的 Token 数。

响应示例

{
  "input_tokens": 12
}

字段说明

字段	类型	说明
`input_tokens`	integer	输入 Token 数，为非负整数。

错误响应¶

缺少必填模型 ID 时返回 HTTP 400。补充模型 ID 后重新提交。

响应示例

{
  "error": {
    "message": "missing required parameter: model",
    "type": "invalid_request",
    "code": "invalid_request"
  }
}

字段说明

字段	类型	说明
`error`	object	错误信息。
`error.message`	string	错误原因；示例表示缺少模型 ID。
`error.type`	string	错误类别，模型服务返回时可能省略。
`error.code`	string 或 null	错误代码，模型服务返回时可能省略。

后续操作¶

确认输入长度后，使用相同模型和消息创建 Message。

最后更新于 2026 年 9 月 8 日