免费中文分词（文本处理）：5 分钟快速接入，从注册到第一条分词结果
免费中文分词文本处理中文NLPAPI教程ShowAPI # 免费中文分词（文本处理）：5 分钟快速接入，从注册到第一条分词结果
> 接口：中文分词（2663-1）｜是否免费：是（含档位限制）｜请求方式：POST/GET｜返回格式：JSON｜适用人群：新注册用户、初级开发者｜阅读时间：约 5 分钟
## 核心要点
- 注册 ShowAPI 账号、在控制台拿到 AppKey，即可免费调用中文分词接入点 `2663-1`。
- 一次调用只需两个参数：`text`（要分词的文本，必填）和可选的 `type`（分词类型）。
- 返回包裹在 `showapi_res_body` 里，分词结果是一个 `words` 数组，每项含 `word` 与 `pos`（词性）。
## Why
中文分词几乎是所有中文 NLP 任务的第一步：搜索引擎建索引、内容平台打标签、客服机器人做意图识别，都得先把一句话切成「词」。ShowAPI 把这个能力做成了一个免费、无需自建模型的 HTTP 接口——你不用懂算法，发一段文本就能拿到带词性的分词结果。对想快速验证想法、又不想养一套分词服务的个人和团队，这是最低成本的起点。
## What
**前置条件**
- 一个 ShowAPI 账号（免费注册）。
- 一对 AppKey / Secret（在控制台「我的应用」里创建）。
- 任意能发 HTTP 请求的环境（Python、Node.js、命令行均可）。
**接口速览**
| 项 | 值 |
|------|------|
| 接口地址 | `https://route.showapi.com/2663-1` |
| 鉴权 | query 参数 `appKey=YOUR_APPKEY` |
| 请求方式 | POST 或 GET |
| 请求格式 | `application/x-www-form-urlencoded` |
| 必填参数 | `text` |
| 可选参数 | `type`（标准分词/nlp/index/nShort/crf/fast，默认标准分词） |
| 返回格式 | JSON，业务数据在 `showapi_res_body` |
| 计费 | 免费（注册默认档位，含调用限制） |
## How
### 步骤 1：拿到 AppKey
登录后进入 [AppKey 管理](https://www.showapi.com/console#/myApp)，创建应用即可看到 AppKey。下文用 `YOUR_APPKEY` 占位，替换成你自己的即可。
### 步骤 2：发一次请求（三语言任选）
**Python（requests）**
```python
import requests
url = "https://route.showapi.com/2663-1"
params = {"appKey": "YOUR_APPKEY"}
data = {
"text": "Java是一门面向对象编程语言",
"type": "standard", # 可选：standard/nlp/index/nShort/crf/fast
}
try:
resp = requests.post(url, params=params, data=data, timeout=10)
resp.raise_for_status()
body = resp.json()["showapi_res_body"]
if body.get("ret_code") != 0:
raise RuntimeError(f"业务失败: {body.get('remark')}")
for item in body["words"]:
print(item["word"], item["pos"])
except requests.RequestException as e:
print("请求异常:", e)
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/2663-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
--data-urlencode "text=Java是一门面向对象编程语言" \
--data-urlencode "type=standard"
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/2663-1?appKey=YOUR_APPKEY";
const body = new URLSearchParams();
body.set("text", "Java是一门面向对象编程语言");
body.set("type", "standard");
fetch(url, { method: "POST", body, headers: { "content-type": "application/x-www-form-urlencoded" } })
.then(r => r.json())
.then(res => {
const b = res.showapi_res_body;
if (b.ret_code !== 0) throw new Error("业务失败: " + b.remark);
b.words.forEach(it => console.log(it.word, it.pos));
})
.catch(e => console.error("请求异常:", e));
```
### 步骤 3：解析返回
返回里 `showapi_res_body.words` 就是分词结果数组，逐条打印 `word`（词语）和 `pos`（词性）即可。
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_body": {
"ret_code": 0,
"remark": "成功",
"words": [
{ "word": "Java", "pos": "nx" },
{ "word": "是", "pos": "vshi" },
{ "word": "一门", "pos": "m" },
{ "word": "面向对象", "pos": "gi" },
{ "word": "编程语言", "pos": "gi" }
]
}
}
```
- `showapi_res_code`：系统级状态码，0 表示请求成功。
- `ret_code`：业务级状态码，0 表示分词成功。
- `words`：分词结果，每项 `word` 是词、`pos` 是词性标注（如 `nx` 名词、`v` 动词、`gi` 习语）。
- `remark`：返回描述。
## 进阶 / 边界
- **切换分词类型**：改 `type` 参数即可（详见 [6 种分词类型对比](https://www.showapi.com/guides/cnseg-types-2663)）。
- **免费档返回为空**：在默认免费档位下，个别账号可能返回 `words:[]`（请求成功但业务数据为空）。这不是代码错误，通常是档位限制所致——先到 [免费档位说明](https://www.showapi.com/free-api) 确认额度，或参考 [免费档位与调用策略](https://www.showapi.com/guides/cnseg-free-tier-2663) 的排查路径。
## FAQ
**Q1：AppKey 在哪里获取？**
在 [AppKey 管理](https://www.showapi.com/console#/myApp) 创建应用后即可看到，替换代码里的 `YOUR_APPKEY`。
**Q2：返回 words 是空数组，是调用失败吗？**
不一定。若 `showapi_res_code` 与 `ret_code` 都为 0，说明请求成功、计费已发生，但免费档位可能限制返回数据。建议核对档位额度（见 [免费档位与调用策略](https://www.showapi.com/guides/cnseg-free-tier-2663)）。
**Q3：支持 GET 请求吗？**
支持。POST 和 GET 均可，鉴权都通过 query 参数 `appKey` 传递；文本较长时建议用 POST。
**Q4：请求编码有什么要求？**
请求体用 `application/x-www-form-urlencoded`，文本按 UTF-8 提交即可。
**Q5：除了分词，这个接口还能做什么？**
它是一个 13 接入点产品，还包含人名/地名/机构名识别、关键词/摘要抽取、简繁转换、汉字转拼音等，详见 [指南总目录](https://www.showapi.com/guides/cnseg-guides-2663)。
## 相关能力 / 下一步阅读
- [免费中文分词（文本处理）：返回结构与公共字段全解](https://www.showapi.com/guides/cnseg-response-2663)
- [免费中文分词（文本处理）：6 种分词类型怎么选？](https://www.showapi.com/guides/cnseg-types-2663)
- [免费中文分词（文本处理）：如何用接口做人名/地名/机构名识别（NER 实战）](https://www.showapi.com/guides/cnseg-ner-2663)
> 本系列共 14 篇：查看[免费中文分词（文本处理）API 指南总目录](https://www.showapi.com/guides/cnseg-guides-2663)
