免费中文分词（文本处理）：免费档位到底能调多少？档位限制、showapi_fee_num 与调用策略
免费中文分词文本处理中文NLPAPI教程ShowAPI # 免费中文分词（文本处理）：免费档位到底能调多少？档位限制、showapi_fee_num 与调用策略
> 接口：全部 13 个接入点（2663-1 ~ 2663-13）｜是否免费：是（含档位限制）｜适用人群：所有接入用户｜阅读时间：约 7 分钟
## 核心要点
- 注册后默认可免费调用本接口，但「为防止滥用设有使用档次限制」——具体档位数字以官方档位说明为准，本文不编造。
- 每次返回里的 `showapi_fee_num` 表示「本次计费次数」，免费档下也会返回（计入档位），不等于金额。
- 实测：默认免费档位下，部分接入点（如中文分词、人名识别）可能返回 `words/names` 为空数组（请求成功但无业务数据）——遇此先查档位，不是代码错。
## Why
免费是最低的门槛，但「免费」不等于「无限」。很多开发者第一次跑通返回空数组就以为接口坏了，其实多半是档位限制。把计费模型、额度字段、空结果排查路径讲清楚，既能少走弯路，也能在真正需要更高吞吐时，知道去哪升级、花不花钱。
## What
**计费事实（来自官方文档）**
- 本接口为「免费服务」：注册后默认可免费调用。
- 设「使用档次限制」防止滥用；权益档次可用平台积分兑换更高调用档位。
- 具体档位数值、每日/每月额度未在接口详情页给出，统一以 [免费档位说明](https://www.showapi.com/free-api) 为准。
- 返回的 `showapi_fee_num` 是本次调用计数（如 1），免费档下也会计入档位额度。
## How
每次调用都顺手打印额度计数，便于定位是否触顶：
```python
import requests
resp = requests.post(
"https://route.showapi.com/2663-1",
params={"appKey": "YOUR_APPKEY"},
data={"text": "自然语言处理", "type": "standard"},
timeout=10,
).json()
outer = resp
body = outer["showapi_res_body"]
print("系统码:", outer.get("showapi_res_code"), "| 计费次数:", outer.get("showapi_fee_num"))
print("业务码:", body.get("ret_code"), "| 数据:", body.get("words"))
```
**空结果排查路径**
1. `showapi_res_code == 0` 且 `ret_code == 0`？→ 请求成功，继续看第 2 步。
2. `words`/`names`/`list` 等业务字段为空数组？→ 多半是免费档位限制，去 [免费档位说明](https://www.showapi.com/free-api) 核对额度。
3. `ret_code != 0`？→ 看 `remark` 的业务描述，按提示修正参数。
4. `showapi_res_code != 0`？→ 看 `showapi_res_error`，通常是鉴权/参数级系统错误。
## 返回示例与解析
默认免费档位下可能看到的「成功但空」：
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": { "ret_code": 0, "remark": "成功", "words": [] }
}
```
- `showapi_fee_num: 1` 说明这次调用已被计数（计入档位）。
- `words: []` 是档位限制下的典型表现，不是解析错误。
## 进阶 / 边界
- **升级姿势**：权益档次可用平台积分兑换更高调用档位，具体路径与数值见官方档位说明页。
- **不要靠 `words` 非空判断成功**：成功但空是免费档常态，务必用 `ret_code` 判断业务成败。
- **计费与 `type`/接入点无关**：每个接入点每次调用独立计数。
## FAQ
**Q1：免费档每天能调多少次？**
详情页未给出具体数值，以 [免费档位说明](https://www.showapi.com/free-api) 为准，本文不编造数字。
**Q2：showapi_fee_num=1 是扣了 1 元吗？**
不是，它只是「本次调用计数 1 次」，免费档下计入档位额度，不等于金额。
**Q3：返回 words 为空是接口坏了？**
大概率不是。免费档限制下会返回空业务数据，先核对档位额度。
**Q4：怎么提升额度？**
用平台积分兑换更高权益档次，详见官方档位说明页。
**Q5：付费后返回就会有数据吗？**
更高档位通常解除空结果限制，具体以你账号实际档位与官方说明为准。
## 相关能力 / 下一步阅读
- [免费中文分词（文本处理）：返回结构与公共字段全解](https://www.showapi.com/guides/cnseg-response-2663)
- [免费中文分词（文本处理）：5 分钟快速接入](https://www.showapi.com/guides/cnseg-quickstart-2663)
- [免费中文分词（文本处理）：导入 Postman / Swagger UI，用 OpenAPI 文档管理你的接口](https://www.showapi.com/guides/cnseg-openapi-2663)
> 本系列共 14 篇：查看[免费中文分词（文本处理）API 指南总目录](https://www.showapi.com/guides/cnseg-guides-2663)
