内容创作/文案灵感：如何把免费经典语句 API 嵌进你的写作工具？
# 内容创作/文案灵感：如何把免费经典语句 API 嵌进你的写作工具？
> 元信息：接口 1646-2 · 免费 · 请求方式 POST/GET · 返回 JSON · 适用人群 内容创作者/工具开发者 · 阅读时间 6 分钟
## 核心要点
- 把取句做成"写作侧边栏一键插入"，比复制粘贴语料库更高效，且免费零成本。
- 插入署名建议固定格式「内容 —— 作者《出处》」，尊重出处又提升可信度。
- 用本地缓存池避免连续插入同一句；可用 `tag` 做主题灵感（如「学习」）。
## Why：写作灵感为什么值得接 API
写文章、做 PPT、发朋友圈，常常卡在"开头/结尾那一句点睛"。手动翻语录书慢，自建库更新难。免费经典语句 API 让你在写作工具里一键取句、即时插入，灵感不断档。
## What：嵌入方式选择
| 方式 | 适合 | 要点 |
|------|------|------|
| 侧边栏按钮 | 笔记/文档类工具 | 点击→调用→插入当前光标 |
| 快捷键取句 | 编辑器插件 | 绑定快捷键，弹出语句卡片 |
| 批处理生成 | 文案模板 | 一次生成多条备用（注意接口单次单条） |
## How：编辑器插件取句（伪代码 + 真实调用）
**取句函数（Node.js，供插件调用）**
```javascript
async function getQuote(tag) {
const url = `https://route.showapi.com/1646-2?appKey=YOUR_APPKEY`;
const form = new URLSearchParams();
if (tag) form.append("tag", tag);
const resp = await fetch(url, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: form,
});
const js = await resp.json();
if (js.showapi_res_code !== 0 || js.showapi_res_body.ret_code !== 0) {
throw new Error(js.showapi_res_error || "取句失败");
}
const b = js.showapi_res_body;
// 固定署名格式
return `${b.body} —— ${b.author}《${b.name}》`;
}
```
**插入到文档（示意）**
```javascript
const quote = await getQuote("学习");
editor.insertText(`\n> ${quote}\n`);
```
Python（写作脚本批量取备用句）：
```python
import requests
def get_quote(tag=None):
url = "https://route.showapi.com/1646-2"
params = {"appKey": "YOUR_APPKEY"}
data = {"tag": tag} if tag else {}
js = requests.post(url, params=params, data=data, timeout=10).json()
if js.get("showapi_res_code") == 0 and js["showapi_res_body"].get("ret_code") == 0:
b = js["showapi_res_body"]
return f"{b.get('body')} —— {b.get('author')}《{b.get('name')}》"
return None
# 取 5 条备用（接口单次单条，循环调用；建议本地去重）
pool = set()
while len(pool) < 5:
q = get_quote("学习")
if q:
pool.add(q)
```
## 返回示例与解析
取到的语句形如：「书山有路勤为径，学海无涯苦作舟。 —— 韩愈《古今贤文》」。字段来源见 [返回字段全解](https://www.showapi.com/guides/classic-quotes-fields-1646)。
## 进阶 / 边界
- **单次单条**：接口文档示例为单条返回，未说明批量；"取 N 条"需循环调用并本地去重。
- **署名规范**：`author` 是作者、`name` 是出处，混用会误导读者；固定一种格式最稳。
- **版权提示**：接口未声明语句版权归属，正式发布内容建议保留作者与出处署名，规避侵权风险。
## FAQ
**Q：能一次取 10 条做素材库吗？**
接口单次返回单条，文档未承诺批量；需循环调用 10 次并在本地去重，注意低频调用。
**Q：tag 能用来做"励志/爱情"等主题吗？**
`tag` 为可选软筛选，文档仅示例「学习」，未给全量标签；可用但结果以接口实际返回为准。
**Q：插入后想换一句怎么办？**
再次调用取句函数覆盖插入即可；配合本地缓存可避免连续相同。
**Q：商用发布需要注意什么？**
接口未声明版权，建议保留「作者《出处》」署名；如用于商业物料，自行评估出处合规性。
**Q：写作工具里怎么避免接口异常卡住输入？**
取句做成异步、失败静默兜底（用上一次缓存句），不要让网络异常阻塞主编辑流。
## 相关能力 / 下一步阅读
- [免费经典语句 API 标签筛选](https://www.showapi.com/guides/classic-quotes-tag-filter-1646) — tag 用法
- [免费接口也要省：经典语句客户端缓存策略](https://www.showapi.com/guides/classic-quotes-cache-1646) — 本地去重
- [自媒体/文案团队方案](https://www.showapi.com/guides/classic-quotes-media-plan-1646) — 批量金句卡片
- **本系列共 11 篇**：查看[免费经典语句 API 开发指南总目录](https://www.showapi.com/guides/classic-quotes-guides-1646)
