# Token Count 计算token数，请求与创建Chat Completion接口类似 ## 请求地址 `POST https://api.stepfun.com/v1/token/count` ## 请求参数 * `model` `string` ***required***
需要使用的模型名称 * `messages` `object array` ***required***
迄今为止用户输入或模型生成的不同类别消息列表 - 系统消息 `object` * `role` `string`
系统类别名称，总是为`system` * `content` `string`
系统消息的文本内容 - 用户消息 `object` * `role` `string`
用户类别名称，总是`user` * `content` `string or object array`
用户消息内容，类型为`multipart`消息列表或者普通文本消息字符串 - `普通文本消息` `string` - `multipart`消息列表 `object array`
结构化的图文混合消息 * 文本消息 `object` - `type` `string`
总为`text` - `text` `string`
消息文本内容 * 图片消息 `object` - `type` `string`
总为`image_url` - `image_url` object * `url` `string`

图片地址或base64编码的图片

图片地址仅支持http和https协议

base64格式举例：```data:image/jpeg;base64,${base64_string}```，请更换图片格式(jpeg)及对应的base64编码后字符串

本接口支持的图片格式：jpg/jpeg、png、webp、静态gif

- 聊天助手消息 `object` * `role` string
聊天助手类别名称，总是为`assistant` * `content` `string | null`
聊天助手消息的文本内容 ## 请求响应 * `data` `object`
计算token返回数据 * `total_tokens` `int`
输入token数 ## 示例 ```bash copy curl https://api.stepfun.com/v1/token/count \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $STEP_API_KEY" \ -d '{ "model": "step-1-8k", "messages": [ { "role": "system", "content": "你是由阶跃星辰提供的AI聊天助手，你擅长中文，英文，以及多种其他语言的对话。在保证用户数据安全的前提下，你能对用户的问题和请求，作出快速和精准的回答。同时，你的回答和建议应该拒绝黄赌毒，暴力恐怖主义的内容。" }, { "role": "user", "content": "你好，请介绍一下阶跃星辰的人工智能！" } ] }' ``` ```json filename="返回" copy { "data": { "total_tokens": 85 } } ``` ```bash copy curl https://api.stepfun.com/v1/token/count \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $STEP_API_KEY" \ -d '{ "model": "step-1v-8k", "messages": [ { "role": "system", "content": "你是由阶跃星辰提供的AI聊天助手，你除了擅长中文，英文，以及多种其他语言的对话以外，还能够根据用户提供的图片，对内容进行精准的内容文本描述。在保证用户数据安全的前提下，你能对用户的问题和请求，作出快速和精准的回答。同时，你的回答和建议应该拒绝黄赌毒，暴力恐怖主义的内容" }, { "role": "user", "content": [ { "type": "text", "text": "用优雅的语言描述这张图片" }, { "type": "image_url", "image_url": { "url": "https://www.stepfun.com/assets/section-1-CTe4nZiO.webp" } } ] } ] }' ``` ```json filename="返回" copy { "data": { "total_tokens": 497 } } ``` ```bash copy # 加载图片到内存，仅演示。按需改成读文件等 image_base64="data:image/webp;base64,"$(curl -s "https://www.stepfun.com/assets/section-1-CTe4nZiO.webp" | base64) curl https://api.stepfun.com/v1/token/count \ -H "Content-Type: application/json" \ -H "Authorization: Bearer $STEP_API_KEY" \ -d "{ \"model\": \"step-1v-8k\", \"messages\": [ { \"role\": \"system\", \"content\": \"你是由阶跃星辰提供的AI聊天助手，你除了擅长中文，英文，以及多种其他语言的对话以外，还能够根据用户提供的图片，对内容进行精准的内容文本描述。在保证用户数据安全的前提下，你能对用户的问题和请求，作出快速和精准的回答。同时，你的回答和建议应该拒绝黄赌毒，暴力恐怖主义的内容\" }, { \"role\": \"user\", \"content\": [ { \"type\": \"text\", \"text\": \"用优雅的语言描述这张图片\" }, { \"type\": \"image_url\", \"image_url\": { \"url\": \"${image_base64}\" } } ] } ] }" ``` ```json filename="返回" copy { "data": { "total_tokens": 497 } } ```

联系我们