中文分词接口：常见问题与避坑指南（粒度/繁体/词性标注）

# 中文分词接口：常见问题与避坑指南（粒度/繁体/词性标注） > 接口：中文分词接口（269-1） · 免费 · POST/GET · JSON · 适用人群：所有使用者 · 阅读时间：6 分钟 ## 核心要点 - 分词粒度由接口决定，**请求参数中无法调节**；如需更粗/更细可在业务层做词典合并或拆分。 - 返回结构只有 `list`（分词数组）+ `ret_code`，**没有词性、实体、新词等扩展字段**——这是本文重点澄清的误区。 - 繁体、生僻字、新词表现以实测为准，不要预设结果；调用失败先查网关层再查业务层。 ## Why：先把预期拉对齐 很多"接口不行"的抱怨，其实是预期和返回结构没对齐：以为能拿到词性、以为能调粒度。本文把高频误解一次说清，省去来回试错。 ## 高频问题 ### 1. 返回里为什么没有词性/实体/新词字段？ 文档描述中写道"支持中文分词、词性标注、命名实体识别与新词识别等功能"，但**实际返回结构、OpenAPI schema、实测返回都只暴露 `list`（分词数组）和 `ret_code`**，没有 `pos`（词性）、`entity`（实体）等字段。 - 这不是 bug 描述，而是"描述与返回不一致"的事实。 - 文章一律按真实返回撰写，不臆造这些字段。 - 若你的业务需要词性/实体，应在分词之上另接专业 NLP 模型，本接口不提供。 ### 2. 分词粒度能调吗？ 不能。请求参数只有 `text`（必填），没有粒度/词典相关的可选参数。粒度由接口底层模型固定。需要"更粗"可在业务层用词典把相邻词合并，需要"更细"目前无法在接口侧控制。 ### 3. 繁体、生僻字、网络新词表现如何？ 以实测返回为准，不要预设。建议： - 繁体：先用真实样本验证粒度，必要时加繁简转换预处理。 - 新词/专有名词：可能切得偏细，可在业务层用词典后处理合并。 ### 4. 调用失败了怎么排查？ 分两层判断： 1. **网关层**：`showapi_res_code` 非 0 → 看 `showapi_res_error`（多为鉴权、网络、计费问题）。 2. **业务层**：`showapi_res_body.ret_code` 非 0 → 业务失败，按返回值处理。 先网关后业务，定位更快。详见[返回字段全解](https://www.showapi.com/guides/chinese-segmentation-response-fields-269)。 ### 5. 免费接口有限制吗？ 有使用档位限制，具体额度以[官方档位说明](https://www.showapi.com/free-api)为准，本文不罗列具体数字。大批量调用请参考[免费档位下的限流与调用策略](https://www.showapi.com/guides/chinese-segmentation-free-tier-269)。 ### 6. 中英文混排怎么切？ 英文单词、数字作为独立词切出（如 `api`、`5999` 各占一个数组元素），标点一般被切分/忽略。详见[中文编码与处理边界](https://www.showapi.com/guides/chinese-segmentation-encoding-269)。 ## 进阶 / 边界 - 不要把"描述提到的能力"等同于"返回里有的字段"——这是本接口最大的认知坑，已在策略与多篇指南中标注为需修正项。 - 业务层后处理（词典合并、停用词、同义词）是发挥分词价值的关键，接口只负责"断词"这一步。 ## FAQ **Q：能不能让接口返回词性？** A：当前不能，返回结构只有 `list`+`ret_code`。需词性请另行接 NLP 模型。 **Q：ret_code 非 0 时有哪些具体错误码？** A：文档仅标注「0 为成功，其他失败」，未给出完整非 0 枚举；代码用 `!= 0` 判失败即可，不要匹配未定义的具体值。 **Q：list 顺序可靠吗？** A：可靠，按原文词序排列。 **Q：一次传多段文本还是循环调用？** A：单接口处理整段文本；超长文本建议切片多次调用，见[长文本切分与批量处理](https://www.showapi.com/guides/chinese-segmentation-long-text-269)。 ## 相关能力 / 下一步阅读 - [中文分词接口返回字段全解：list 分词数组与 ret_code 一文读懂](https://www.showapi.com/guides/chinese-segmentation-response-fields-269) - [中文分词接口：5 分钟从注册到拿到第一条分词结果](https://www.showapi.com/guides/chinese-segmentation-quickstart-269) - [中文分词接口：免费档位下的限流与调用策略](https://www.showapi.com/guides/chinese-segmentation-free-tier-269) - **本系列共 11 篇**：查看[中文分词接口指南总目录](https://www.showapi.com/guides/chinese-segmentation-guides-269)