HSK 汉语分词与等级标注 API 在线调试
实时测试 API 端点、自定义测试参数、即时查看 HTTP 响应并生成多语言调用代码。
API 请求配置
API 响应结果 (Response)
Waiting...
Response JSON Payload
点击“发送 API 请求”进行实时测试...
HSK API 接口规格说明文档
标准的 RESTful HTTP 接口定义，包含鉴权机制、参数说明与错误码规范。
🛡️ 认证与访问控制 (Authentication)
除健康检查 /api/health 外，访问受保护的端点需要提供有效 API Key。
方式一：HTTP Header (推荐)
X-API-Key: YOUR_API_KEY
方式二：Bearer Authorization Header
Authorization: Bearer YOUR_API_KEY
限流与保护规范： 正式 API 单 IP 限制 60 次/分钟，单次文本上限为 10,000 字符；网页可视化体验使用独立的公开演示接口，不会向浏览器下发 API Key。
POST
/api/segment
快捷分词并返回含 HSK 等级标记的文本
请求参数 (Request Body)
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
text | String | 是 | 待分析标注的中文文本 (最大 10,000 字) |
响应字段 (Response)
| 字段名 | 类型 | 说明 |
|---|---|---|
result | String | 拼接带有 HSK 等级标记的文本，例如：我[1]爱[1]学习[1]汉语[1]。 |
tokens | Array[Object] | 分词后的详细 Token 词条列表及词性、拼音、难度系数 |
meta | Object | 词典基准元数据信息 |
POST
/api/analyze
完整结构化分词与 HSK 维度分析
请求参数 (Request Body)
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
text | String | 是 | 待分析标注的中文文本 |
响应字段 (Response)
| 字段名 | 类型 | 说明 |
|---|---|---|
tokens[].text | String | 切分出的词汇或标点文本 |
tokens[].kind | String | "word" (词汇) 或 "text" (标点/空格/其他) |
tokens[].known | Boolean | 是否收录于 HSK 官方词汇大纲中 |
tokens[].display_level | String | 词汇对应的 HSK 等级（如 "1"、"1/4" 或 "未收录"） |
tokens[].pinyin | Array[String] | 词汇的标准汉语拼音 |
tokens[].pos | Array[String] | 词性标注（如名词、动词、形容词） |
GET
/api/health
公开的服务健康检查接口
无需携带 API Key，用于监控服务连通性。
响应示例
{"status": "ok", "service": "hsk-segmenter-api", "version": "1.1.0"}
HSK 课文分词与等级高亮体验区
可视化的课文阅读标注面板，支持按颜色展示 HSK 1-7 级词汇并一键导出 TXT。
输入课文
标注高亮展示
等待分析
分析结果将高亮显示在这里...