# 内容创作者如何用生成文章摘要做选题与二次创作
> 接口 961-1 · 免费（受使用档次限制） · 请求方式 POST/GET · 返回格式 JSON · 适用人群：自媒体、编辑、运营 · 阅读时间：约 7 分钟
## 核心要点
- 把长文丢进接口，快速得到 N 条要点，当作选题线索或大纲骨架。
- 抽出的短句适合做社媒金句、短视频口播提纲，但需人工润色与事实核对。
- 免费额度有限，日常轻量使用足够；批量搬运长文要注意配额。
## Why：创作者的两个真实痛点
写东西最费时间的两步是「读完素材」和「起提纲」。生成文章摘要接口帮你把一篇长文压成几条核心点，你拿着要点就能快速判断要不要写、怎么写，省下大量阅读与列纲时间。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 接口地址 | `https://route.showapi.com/961-1?appKey={your_appKey}` |
| 必填参数 | `text`（素材正文）、`num`（要点条数） |
| 返回 | `showapi_res_body.list`（字符串数组） |
| 计费 | 免费，受使用档次限制 |
## How：三步用到创作流里
### 1）素材转要点
```python
import requests
APPKEY = "YOUR_APPKEY"
resp = requests.post(
"https://route.showapi.com/961-1",
params={"appKey": APPKEY},
data={"text": "在这里粘贴你搜集到的长素材……", "num": "5"},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=30,
)
data = resp.json()
body = data.get("showapi_res_body", {})
if str(body.get("ret_code")) != "0":
raise RuntimeError(f"业务失败 ret_code={body.get('ret_code')}")
for i, point in enumerate(body["list"], 1):
print(f"要点{i}：{point}")
```
### 2）把要点变社媒金句（人工润色）
接口返回的是短句/关键词（如「提升学习效率」），适合作为金句底料。建议人工扩写成完整句子，并核对事实后再发布。
### 3）做选题判断
`num` 调大（如 8~10）看覆盖面，`num` 调小（如 3）看最核心的 3 个点，据此决定文章角度。
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 1,
"showapi_res_body": {
"ret_code": "0",
"list": [
"提升学习效率",
"AI带来的不仅是效率提升",
"在制造领域",
"工业机器人提升产线自动化水平",
"个性化学习平台根据学生特点推送内容"
]
}
}
```
## 进阶 / 边界
- **输出是要点不是成稿**：返回为短句/关键词，不能直接当正文发布，需人工组织与润色。
- **事实核对不可省**：摘要由算法生成，可能出现偏差，发布前务必对照原文核实数据与表述。
- **短素材条数少**：素材太短，`list` 可能少于 `num`，属正常，可补更多素材再调用。
- **配额意识**：每次调用扣 1 次免费额度，日常轻量够用，批量处理参考 [批量处理最佳实践](https://www.showapi.com/guides/article-summary-batch-961)。
## FAQ
**Q1：可以直接把 `list` 当文章发吗？**
A：不建议。`list` 是要点碎片，需人工扩写、串联成完整内容，并核对事实。
**Q2：`num` 设多大合适？**
A：选题阶段可设 8~10 看全貌，成稿提纲设 3~5 抓重点，按用途调整。
**Q3：返回的内容和我原文不一致怎么办？**
A：算法提炼可能泛化，以原文为准做最终核对；如偏差大可缩短 `text` 分段调用。
**Q4：免费额度够日常用吗？**
A：轻量使用通常足够；高频批量需关注额度，详见 [免费 API 说明](https://www.showapi.com/free-api)。
**Q5：支持多语言素材吗？**
A：公开文档未说明多语言能力，建议先用中文素材实测；非中文效果以实际返回为准。
## 相关能力 / 下一步阅读
- [生成文章摘要参数详解：text 与 num 的正确用法](https://www.showapi.com/guides/article-summary-params-guide-961)
- [长文与批量摘要处理：超时、限流与免费配额的最佳实践](https://www.showapi.com/guides/article-summary-batch-961)
- **本系列共 8 篇**：查看[生成文章摘要指南总目录](https://www.showapi.com/guides/article-summary-guides-961)
