文本分词器

Tokenizer 用于将文本切分为模型可识别的 token 并计算数量。它接收用户输入的文本，通过模型进行分词处理，最终返回对应的 token 数量。适用于文本长度评估、模型输入预估、对话上下文截断、费用计算等。

POST /paas/v4/tokenizer

Try it

文本分词器

cURL

curl --request POST \
  --url https://open.bigmodel.cn/api/paas/v4/tokenizer \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "model": "glm-4.6",
  "messages": [
    {
      "role": "user",
      "content": "What opportunities and challenges will the Chinese large model industry face in 2025?"
    }
  ]
}
'

200

{
  "id": "20241120141244890ab4ee4af84acf",
  "usage": {
    "prompt_tokens": 123,
    "total_tokens": 123
  },
  "created": 1727156815,
  "request_id": "1"
}

Authorizations

Authorization · string · header · required

使用以下格式进行身份验证：Bearer

Body

application/json

model · enum<string> · default: glm-4.6 · required

调用的模型代码。

Available options: glm-4.6, glm-4.5, glm-4.5-air, glm-4-plus, glm-4-0520, glm-4-long, glm-4-air, glm-4-flash

Example:

"glm-4.6"

messages · (用户消息 · object | 系统消息 · object | 助手消息 · object | 工具消息 · object)[] · required

对话消息列表输入。支持四种角色：system（系统消息）、user（用户消息）、assistant（助手消息）、tool（工具消息）。

Minimum array length: 1

用户消息

Hide child attributes

messages. role · enum<string> · default: user · required

消息作者的角色

Available options: user

messages. content · string · required

文本消息内容

Example:

"What opportunities and challenges will the Chinese large model industry face in 2025?"

tools · Function Call · object[]

模型可以调用的工具列表。支持函数调用、知识库检索和网络搜索。使用此参数提供模型可以生成 JSON 输入的函数列表或配置其他工具。最多支持 128 个函数。目前 GLM-4 系列已支持所有 tools，GLM-4.5 已支持 web search 和 retrieval。

Hide child attributes

tools. type · enum<string> · default: function · required

Available options: function

tools. function · object · required

Hide child attributes

tools.function. name · string · required

要调用的函数名称。必须是 a-z、A-Z、0-9，或包含下划线和破折号，最大长度为 64。

Required string length: 1 - 64

tools.function. description · string · required

函数功能的描述，供模型选择何时以及如何调用函数。

tools.function. parameters · object · required

使用 JSON Schema 定义的参数。必须传递 JSON Schema 对象以准确定义接受的参数。如果调用函数时不需要参数，则省略。

request_id · string

由用户端传参，需保证唯一性,用户传空会默认生成

user_id · string

终端用户的唯一ID

Response

200

application/json

业务处理成功

id · string · required

智谱AI开放平台生成的任务序号，调用请求结果接口时请使用此序号。

Example:

"20241120141244890ab4ee4af84acf"

usage · object · required

Hide child attributes

usage. prompt_tokens · number

本次输入的 prompt tokens

usage. total_tokens · number

本次输入的总 tokens

created · integer<int64>

Example:

1727156815

request_id · string

请求发起时客户端提交的任务号或平台生成的任务号。

Example:

"1"