中文近义词反义词 API：写作润色助手集成实战
中文近义词API中文反义词API免费接口ShowAPI # 中文近义词反义词 API：写作润色助手集成实战
> 接口：免费近义词 - 中文近义词和反义词（apiCode=1624）· 免费服务 · POST/GET · 返回 JSON · 适用人群：内容/产品经理、全栈工程师 · 阅读时间：约 7 分钟
## 核心要点
- 用近义词接入点（`1624-1`）给选中词提供"换词"候选，做写作润色；用反义词接入点（`1624-2`）做对比表达与词义辨析。
- 返回带拼音和释义，可直接展示给用户做选词参考，不必自建词库。
- 免费、单参数、无鉴权复杂度，适合嵌入编辑器侧边栏或写作插件。
## Why：这跟你有什么关系
写稿、写文案、改公文时，最怕词穷或反复用同一个词。与其靠人脑硬想同义词，不如在编辑器里选中一个词，右键"换个说法"就弹出一串近义词。这个接口让"选中词 → 出候选"变成几行代码，你只管把结果渲染成下拉建议。
## What：接口速览（写作场景）
| 项目 | 说明 |
|------|------|
| 近义词接入点 | `https://route.showapi.com/1624-1`（`keyWords`=选中词） |
| 反义词接入点 | `https://route.showapi.com/1624-2` |
| 返回 | `showapi_res_body.result` 数组，元素 `{words, wordsDetail}` |
| 适合嵌入 | 编辑器侧边栏、写作插件、审阅批注 |
## How：做一个"选中词 → 近义词建议"的小组件
### 后端：提供候选接口（Python）
```python
import requests
from flask import Flask, request, jsonify
APP_KEY = "YOUR_APPKEY"
app = Flask(__name__)
@app.route("/suggest")
def suggest():
word = request.args.get("word", "").strip()
if not word:
return jsonify(error="缺少 word"), 400
resp = requests.post(
"https://route.showapi.com/1624-1", # 反义词换成 1624-2
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:
return jsonify(error=data.get("showapi_res_error")), 502
body = data["showapi_res_body"]
if body.get("ret_code") != 0:
return jsonify(error=body.get("remark")), 502
return jsonify([
{"word": i["words"], "detail": i["wordsDetail"]}
for i in body["result"]
])
```
### 前端：选中文本后拉取建议（JavaScript）
```javascript
async function showSynonyms(selectedText) {
const res = await fetch(`/suggest?word=${encodeURIComponent(selectedText)}`);
if (!res.ok) return;
const list = await res.json();
const box = document.getElementById("suggest-box");
box.innerHTML = list.map(i =>
`<li><b>${i.word}</b><br><small>${i.detail}</small></li>`
).join("");
}
// 监听编辑器选区变化，取选中词调用 showSynonyms
```
## 返回示例与解析（真实返回，已精简）
```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ù ] （形）对待别人冷漠残酷：～无情|手段～。"}
]
}
}
```
| 字段 | 说明 |
|------|------|
| `result[].words` | 候选近义词，可直接替换原文选中词 |
| `result[].wordsDetail` | 拼音+词性+释义，展示给用户做选词参考 |
## 进阶 / 边界
- 对比表达：在"金句生成"场景，并行查 `1624-1`+`1624-2`，给用户"换个说法 / 说反话"两种按钮。
- 释义裁剪：`wordsDetail` 可能含多义项（"①…②…"），前端可按句号/分号截断只显示第一项，避免卡片过长。
- 空结果：`result` 为 `[]` 时提示"未找到近义词"，不要渲染空列表。
## FAQ
**Q1：能同时给一句话里每个词都出近义词吗？**
A：接口一次查一个 `keyWords`。需要逐词拆分后多次调用（注意免费额度每次 1 计量），或只针对用户选中的词。
**Q2：返回的释义太长，前端怎么处理？**
A：`wordsDetail` 含拼音+词性+释义，可按第一个句号截断取首句，或完整展示在 tooltip 中。
**Q3：免费接口能做商用写作工具吗？**
A：接口本身免费（消耗免费额度），商用前请确认平台额度与计费规则是否满足你的调用量。
**Q4：近义词和反义词怎么一起用？**
A：分别调用 `1624-1` 与 `1624-2`，可用并行请求缩短等待，详见[双接入点详解](https://www.showapi.com/guides/chinese-synonym-antonym-access-points-1624)。
## 相关能力 / 下一步阅读
- [中文近义词反义词 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)
