中文近义词反义词 API：近义词与反义词双接入点详解
中文近义词API中文反义词API免费接口ShowAPI # 中文近义词反义词 API：近义词与反义词双接入点详解
> 接口：免费近义词 - 中文近义词和反义词（apiCode=1624）· 免费服务 · POST/GET · 返回 JSON · 适用人群：中级开发者 · 阅读时间：约 5 分钟
## 核心要点
- apiCode=1624 下有两个接入点：`1624-1` 返回**近义词**，`1624-2` 返回**反义词**。
- 两个接入点参数完全一致（仅 `keyWords`），区别只在返回内容。
- 同一份代码切换接入点即可同时拿到近义与反义，适合做"一词多查"的词卡。
## Why：为什么有两个接入点
近义词和反义词是两类不同的语言需求：写作用近义词做换词润色，阅读理解/对比表达用反义词。接口把它们拆成两个接入点，调用方按需选择，也方便在同一页面并行请求、拼成完整的"近义+反义"词卡。
## What：两个接入点对照
| 接入点 | 地址 | 返回内容 | 典型用途 |
|------|------|---------|---------|
| 近义词 | `https://route.showapi.com/1624-1` | 该词的近义词数组 | 换词润色、同义替换 |
| 反义词 | `https://route.showapi.com/1624-2` | 该词的反义词数组 | 对比表达、词义辨析 |
公共参数：`keyWords`（必填）、`appKey`（鉴权）。返回结构两者一致：`showapi_res_body.result` 为数组，元素 `{words, wordsDetail}`。
## How：一次拿到近义 + 反义
```python
import requests
APP_KEY = "YOUR_APPKEY"
BASE = "https://route.showapi.com/"
def query(point: str, word: str):
resp = requests.post(
BASE + point,
params={"appKey": APP_KEY},
data={"keyWords": word},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=10,
)
data = resp.json()
if data.get("showapi_res_code") != 0:
raise RuntimeError(data.get("showapi_res_error"))
body = data["showapi_res_body"]
if body.get("ret_code") != 0:
raise RuntimeError(body.get("remark"))
return [item["words"] for item in body["result"]]
word = "热情"
syn = query("1624-1", word) # 近义词
ant = query("1624-2", word) # 反义词
print(f"「{word}」近义词：{syn}")
print(f"「{word}」反义词：{ant}")
```
> 注：上述用"热情"仅为示意；真实反义词返回以[接口详情页](https://www.showapi.com/apiGateway/view/1624/2)实测为准。近义词接入点真实返回示例见[快速开始](https://www.showapi.com/guides/chinese-synonym-antonym-quickstart-1624)。
## 返回示例与解析（真实返回，已精简）
**近义词（1624-1，词"残酷"）**
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": {
"ret_code": 0,
"result": [
{"words": "严酷", "wordsDetail": "[ yán kù ] （形）①严厉；严格：～的教训。②残酷；冷酷：～的剥削。"},
{"words": "冷酷", "wordsDetail": "[ lěng kù ] （形）对待别人冷漠残酷：～无情|手段～。"}
]
}
}
```
**反义词（1624-2，词"热情"）**
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": {
"ret_code": 0,
"result": [
{"words": "冷淡", "wordsDetail": "[ lěng dàn ] （形）不热闹；不兴盛…②对人或事没有热情，毫不关心：态度～。"},
{"words": "冷漠", "wordsDetail": "[ lěng mò ] （形）对人或事物冷淡，不关心：态度～。"},
{"words": "冷酷", "wordsDetail": "[ lěng kù ] （形）对待别人冷漠残酷：～无情|手段～。"}
]
}
}
```
字段含义与[返回结构全解](https://www.showapi.com/guides/chinese-synonym-antonym-response-codes-1624)一致：`result` 为数组，元素含 `words` 与 `wordsDetail`。
## 进阶 / 边界
- 并行请求：两个接入点相互独立，可用 `asyncio`/`Promise.all` 并行查近义+反义，缩短词卡生成耗时。
- 结果数量不一：近义词和反义词返回条数不固定，前端做卡片时按实际数组长度渲染，不做固定列数假设。
- 免费额度：每次调用（无论近义或反义）都消耗 1 计量，并行查询时注意总量。
## FAQ
**Q1：两个接入点能合并成一次请求吗？**
A：不能。它们是独立接入点，需分别调用 `1624-1` 与 `1624-2`。可用并行请求减少等待。
**Q2：返回结构两个接入点一样吗？**
A：一样。都返回 `showapi_res_body.result` 数组，元素 `{words, wordsDetail}`，仅内容分别为近义/反义。
**Q3：参数 keyWords 在近义和反义里含义一样吗？**
A：一样，都是"要查询的那个词"。区别完全由接入点决定。
**Q4：一次查一个词要两次调用，额度怎么算？**
A：每次调用消耗 1 计量（免费接口 `showapi_fee_num=1`），近义+反义合计 2 计量。
## 相关能力 / 下一步阅读
- [中文近义词反义词 API：返回结构全解（ret_code 与 result 数组）](https://www.showapi.com/guides/chinese-synonym-antonym-response-codes-1624)
- [中文近义词反义词 API：语文词汇学习场景集成](https://www.showapi.com/guides/chinese-synonym-antonym-edu-vocab-1624)
- **本系列共 8 篇**：查看[中文近义词反义词 API 使用指南总目录](https://www.showapi.com/guides/chinese-synonym-antonym-guides-1624)
