# Token计算器
#### 功能介绍
为了帮助用户更好地管理和优化Token消耗，平台提供了Token计算器工具。Token计算器可以帮助用户在模型推理前评估文本的Token数量，提供费用预估，并优化数据预处理策略。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/productdesc-pangulm/pangulm_01_0020.html)。
#### URI
POST /v1/{project_id}/deployments/{deployment_id}/caltokens
获取URI方式请参见[请求URI](https://support.huaweicloud.com/api-pangulm/pangulm_05_0004.html)。
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| project_id    | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-pangulm/pangulm_05_0021.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及            |
| deployment_id | 是    | String | **参数解释：** 模型的部署ID，获取方法请参见[获取模型部署ID](https://support.huaweicloud.com/api-pangulm/pangulm_05_0023.html)。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token。 用于获取操作API的权限。如[图4](https://support.huaweicloud.com/api-pangulm/pangulm_05_0009.html#pangulm_05_0009__fig10797003103)中响应消息头中X-Subject-Token的值即为Token。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| Content-Type | 是    | String | **参数解释：** 发送的实体的MIME类型。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** application/json                                                                                                                                                                       |
   
表3请求Body参数 
| 参数          | 是否必选 | 参数类型           | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|:---|
| data        | 是    | List\<String\> | **参数解释：** 待统计Token数的字符串。List长度必须为奇数。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及                                                                                                                                                                                                            |
| with_prompt | 否    | Boolean        | **参数解释：** 是否仅统计输入字符的Token数。 **约束限制：** 不涉及 **取值范围：** - true：仅统计输入字符串的Token数。  - false：统计输入字符串和推理过程产生字符的总Token数。   **默认取值：** 不涉及 |
   
#### 响应参数
表4响应Body参数 
| 参数           | 参数类型           | 描述                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| tokens       | List\<String\> | **参数解释：** 分解出的Token列表。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
| token_number | Integer        | **参数解释：** Token总数统计结果。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及       |
   
#### 请求示例
```
{
    "data": [
        "你好，请介绍下西安。"
    ],
    "with_prompt": true
}
```
#### 响应示例
```
{
    "tokens": [
        "你好",
        "，",
        "请",
        "介绍下",
        "西安",
        "。"
    ],
    "token_number": 6
}
```
#### 状态码
请参见[状态码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0019.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-pangulm/pangulm_05_0020.html)。