# 中文文本相似度检测接口指南总目录
> 中文文本相似度检测接口（apiCode=294）是万维易源（ShowAPI）的**免费**文本语言类接口，基于余弦相似度算法，通过计算文本向量夹角评估两段中文文本的相似程度，广泛应用于文本去重、内容聚类、推荐等场景。本目录汇总全系列指南，帮助不同角色的读者按需取用。
## 接口一句话速览
- **定位**：免费中文文本相似度检测，返回 0~1 的相似度分值。
- **接入点**：2 个
- **文本相似度检测接口（294/1）**：传入两个文本 `t1`、`t2`，返回相似度 `like`。
- **批量检测接口（294/2）**：传入 1 个文本 `t1` 与一组候选文本数组 `t2`，返回最匹配项的数组下标 `mostLike` 与相似度 `likeValue`。
- **请求方式**：POST / GET；**返回格式**：JSON。
- **计费**：免费接口，平台统一档位 L0（100 次/天、1 QPS）至 L4（50,000 次/天、50 QPS）。
- **语言限制**：两个接入点均**不支持英文与数字**检测，仅适用于中文。
- **集成**：提供 MCP 服务与 OpenAPI 3.0 文档。
## 分层文章导航
### 入门层
1. [中文文本相似度检测接口：5 分钟从注册到第一条相似度结果](https://www.showapi.com/guides/text-similarity-quickstart-294) — 注册、取 AppKey、首次调用、解析 `like`，附可直接运行的代码。
2. [中文文本相似度检测接口返回字段全解：like / likeValue / mostLike / ret_code 一文读懂](https://www.showapi.com/guides/text-similarity-response-fields-294) — 厘清两个接入点的返回字段差异与状态码含义。
### 场景实战层
3. [中文文本相似度检测接口实战：UGC 评论 / 文章去重从采集到判重的全链路设计](https://www.showapi.com/guides/text-similarity-dedup-294) — 用相似度做内容去重的完整方案。
4. [中文文本相似度检测接口批量匹配：单文本 vs 候选库如何定位最相似项](https://www.showapi.com/guides/text-similarity-batch-294) — 接入点 2 的批量匹配用法与同步模型说明。
5. [中文文本相似度检测接口只支持中文？英文数字检测的边界与应对策略](https://www.showapi.com/guides/text-similarity-chinese-only-294) — 语言限制的边界与预处理兜底思路。
### 技术深挖层
6. [余弦相似度原理通俗版：中文文本相似度检测接口背后的"余弦定理与新闻分类"](https://www.showapi.com/guides/text-similarity-cosine-294) — 算法源于 Google 黑板报《数学之美》的直觉讲解。
7. [相似度阈值怎么定？用中文文本相似度检测接口做判重的工程实践](https://www.showapi.com/guides/text-similarity-threshold-294) — 0~1 分值如何转成业务判重决策。
8. [免费档位下如何设计缓存节省调用？L0~L4 档位与 QPS 限制下的优化](https://www.showapi.com/guides/text-similarity-cache-cost-294) — 在免费额度内撑起更大流量的缓存与限流设计。
### 行业方案层
9. [UGC 社区内容治理：用中文文本相似度检测接口打击重复灌水](https://www.showapi.com/guides/text-similarity-ugc-moderation-294) — 社区/评论场景的重复内容识别。
10. [新闻 / 资讯聚合去重方案：多源采集如何用相似度检测接口去重](https://www.showapi.com/guides/text-similarity-news-aggregate-294) — 多源资讯的同题聚类去重。
### 生态集成层
11. [通过 MCP 协议在 AI 客户端中直接调用中文文本相似度检测接口](https://www.showapi.com/guides/text-similarity-mcp-294) — 在 Cherry Studio / ChatBox 等客户端配置 MCP。
12. [导入 Postman / Swagger：用 OpenAPI 文档管理中文文本相似度检测接口](https://www.showapi.com/guides/text-similarity-openapi-294) — 用 OpenAPI 3.0 文档导入 API 工具做治理。
## 相关资源
| 资源 | 链接 |
|------|------|
| 接口详情页（apiCode=294） | https://www.showapi.com/apiGateway/view/294 |
| 接入点 1：文本相似度检测接口 | https://www.showapi.com/apiGateway/view/294/1 |
| 接入点 2：批量检测接口 | https://www.showapi.com/apiGateway/view/294/2 |
| OpenAPI YAML | https://www.showapi.com/openapi/market/294.yaml |
| OpenAPI JSON | https://www.showapi.com/openapi/market/294.json |
| AppKey 管理 | https://www.showapi.com/console#/myApp |
| 免费接口档位说明 | https://www.showapi.com/free-api |
| 调用帮助文档 | https://www.showapi.com/helpcenter/view#/3960/1 |
## 阅读建议
- **第一次接触**：从《5 分钟从注册到第一条相似度结果》开始，跑通一次调用。
- **要做去重/匹配**：读《UGC 评论/文章去重》与《批量匹配》两篇，再结合《相似度阈值》定业务规则。
- **关心成本**：直接看《免费档位下如何设计缓存节省调用》。
- **想接 AI 工具链**：读《MCP 协议调用》与《OpenAPI 文档管理》两篇。
> 本系列共 12 篇，按"入门 → 场景 → 技术 → 行业 → 生态"顺序组织。遇到接口级问题，优先查《返回字段全解》。
