中文近义词反义词 API：语文词汇学习场景集成
中文近义词API中文反义词API免费接口ShowAPI # 中文近义词反义词 API：语文词汇学习场景集成
> 接口：免费近义词 - 中文近义词和反义词（apiCode=1624）· 免费服务 · POST/GET · 返回 JSON · 适用人群：教育产品/语文从业者 · 阅读时间：约 6 分钟
## 核心要点
- 给定任意词，自动生成"近义词 + 反义词"词卡，适合背词、语文作业、词义辨析练习。
- 返回的 `wordsDetail` 自带拼音与释义，可直接作为词卡正文，省去人工录入。
- 词语语义稳定，相同 `keyWords` 可本地缓存，避免重复调用浪费免费额度。
## Why：这跟你有什么关系
语文老师和背词 App 经常需要给学生一张"某词的近义/反义词表"。手工整理费时且不全。这个接口输入一个词就返回一串带拼音释义的近义/反义词，正好用来一键生成词卡或练习题库，老师只做审核即可。
## What：接口速览（教育场景）
| 项目 | 说明 |
|------|------|
| 近义词接入点 | `https://route.showapi.com/1624-1` |
| 反义词接入点 | `https://route.showapi.com/1624-2` |
| 返回 | `result` 数组，元素 `{words, wordsDetail}`（含拼音+词性+释义） |
| 适合场景 | 词卡生成、词义辨析题、默写辅助 |
## How：生成一张"近义+反义"词卡
```python
import requests
APP_KEY = "YOUR_APPKEY"
CACHE = {} # 简单本地缓存：词语语义稳定，可复用
def fetch(point: str, word: str):
key = (point, word)
if key in CACHE:
return CACHE[key]
resp = requests.post(
f"https://route.showapi.com/{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"))
result = [{"word": i["words"], "detail": i["wordsDetail"]} for i in body["result"]]
CACHE[key] = result
return result
def build_card(word: str):
return {
"word": word,
"synonyms": fetch("1624-1", word),
"antonyms": fetch("1624-2", word),
}
card = build_card("热情")
print(card)
```
## 返回示例与解析（真实返回，已精简）
```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ò ] （形）对人或事物冷淡，不关心：态度～。"}
]
}
}
```
| 字段 | 说明 |
|------|------|
| `result[].words` | 近义/反义词，作为词卡条目 |
| `result[].wordsDetail` | 拼音+词性+释义，直接作为词卡正文 |
## 进阶 / 边界
- 缓存策略：词语的近义/反义关系相对稳定，相同 `keyWords` 的返回可本地缓存（如上述 `CACHE`），减少重复调用。详见[缓存与频率最佳实践](https://www.showapi.com/guides/chinese-synonym-antonym-best-practices-1624)。
- 多义项：`wordsDetail` 可能含"①…②…"，生成词卡时可按义项拆分，或只取首句。
- 练习生成：用近义词做"选词填空"、用反义词做"写出反义词"题型，题目与答案都来自接口返回。
## FAQ
**Q1：这个词卡能直接给学生用吗？**
A：返回的 `wordsDetail` 已含拼音和释义，可直接作为词卡内容；建议老师审核近义/反义是否贴合教学语境。
**Q2：为什么要缓存？**
A：词语语义稳定，同一词反复查询返回基本一致。本地缓存相同 `keyWords` 结果可节省免费额度（每次调用消耗 1 计量）。
**Q3：返回为空怎么办？**
A：`result` 为 `[]` 表示该词无关联近义/反义词，属正常结果，词卡对应栏可显示"暂无"。
**Q4：能批量生成整个生词表的词卡吗？**
A：接口一次查一个词。逐词调用即可，注意总调用量=词数×2（近义+反义），关注免费额度。
## 相关能力 / 下一步阅读
- [中文近义词反义词 API：近义词与反义词双接入点详解](https://www.showapi.com/guides/chinese-synonym-antonym-access-points-1624)
- [中文近义词反义词 API：免费接口的缓存与频率最佳实践](https://www.showapi.com/guides/chinese-synonym-antonym-best-practices-1624)
- **本系列共 8 篇**：查看[中文近义词反义词 API 使用指南总目录](https://www.showapi.com/guides/chinese-synonym-antonym-guides-1624)
