5 分钟接入生成文章摘要：从注册到第一条摘要
生成文章摘要快速接入Python示例免费接口API教程 # 5 分钟接入生成文章摘要：从注册到第一条摘要
> 接口 961-1 · 免费（受使用档次限制） · 请求方式 POST/GET · 返回格式 JSON · 适用人群：新注册用户、初级开发者 · 阅读时间：约 5 分钟
## 核心要点
- 只需两个必填参数：`text`（文章正文）和 `num`（想要几条摘要）。
- 鉴权用 query 参数 `appKey`，把 `YOUR_APPKEY` 换成你控制台的 AppKey 即可。
- 返回结果在 `showapi_res_body.list`，是一个字符串数组，每条是一句短摘要。
## Why：这跟我有什么关系
做内容的人经常遇到两个麻烦：长文章没人愿意读完、多条素材要快速提炼要点。生成文章摘要接口帮你把一段长文直接压成 N 条要点，适合稿件导读、社媒金句、资讯快报等场景。接口免费、调用简单，适合先跑通再慢慢深入。
## What：接口速览
| 项目 | 说明 |
|------|------|
| 接口地址 | `https://route.showapi.com/961-1?appKey={your_appKey}` |
| 接入点 | `961-1`（本接口唯一接入点） |
| 请求方式 | POST（推荐）/ GET |
| 鉴权 | query 参数 `appKey` |
| 必填参数 | `text`、`num` |
| 计费 | 免费，受使用档次限制（每次调用从免费额度扣减） |
| 集成能力 | MCP、OpenAPI 3.0 |
## How：三步跑通
### 第 1 步：拿到 AppKey
登录易源控制台 → [我的 AppKey](https://www.showapi.com/console#/myApp) → 复制任意一个 AppKey。
### 第 2 步：发起第一次调用
下面三段代码等价，挑你顺手的。把 `YOUR_APPKEY` 换成真实 AppKey，`text` 换成你的文章正文即可运行。
**Python（requests）**
```python
import requests
APPKEY = "YOUR_APPKEY"
URL = "https://route.showapi.com/961-1"
resp = requests.post(
URL,
params={"appKey": APPKEY},
data={"text": "在这里粘贴你的文章正文……", "num": "3"},
headers={"content-type": "application/x-www-form-urlencoded"},
timeout=30,
)
resp.raise_for_status()
data = resp.json()
if str(data.get("showapi_res_code")) != "0":
raise RuntimeError(f"系统级错误: {data.get('showapi_res_error')}")
body = data["showapi_res_body"]
if str(body.get("ret_code")) != "0":
raise RuntimeError(f"业务失败 ret_code={body.get('ret_code')}")
for i, item in enumerate(body["list"], 1):
print(f"{i}. {item}")
```
**cURL**
```bash
curl -X POST "https://route.showapi.com/961-1?appKey=YOUR_APPKEY" \
-H "content-type: application/x-www-form-urlencoded" \
--data-urlencode "text=在这里粘贴你的文章正文……" \
--data-urlencode "num=3"
```
**Node.js（fetch）**
```javascript
const APPKEY = "YOUR_APPKEY";
const params = new URLSearchParams();
params.append("text", "在这里粘贴你的文章正文……");
params.append("num", "3");
const res = await fetch(`https://route.showapi.com/961-1?appKey=${APPKEY}`, {
method: "POST",
headers: { "content-type": "application/x-www-form-urlencoded" },
body: params,
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const data = await res.json();
if (String(data.showapi_res_code) !== "0") throw new Error(data.showapi_res_error);
const body = data.showapi_res_body;
if (String(body.ret_code) !== "0") throw new Error(`业务失败 ret_code=${body.ret_code}`);
body.list.forEach((item, i) => console.log(`${i + 1}. ${item}`));
```
### 第 3 步：看返回
成功时 `showapi_res_body.ret_code` 为 `"0"`，`list` 里就是你要的摘要数组。
## 返回示例与解析
```json
{
"showapi_res_code": 0,
"showapi_res_error": "",
"showapi_res_id": "6a978509fb638c36635deabe",
"showapi_fee_num": 1,
"showapi_res_body": {
"ret_code": "0",
"list": [
"提升学习效率",
"AI带来的不仅是效率提升",
"在制造领域",
"工业机器人提升产线自动化水平",
"个性化学习平台根据学生特点推送内容"
]
}
}
```
> 说明：以上为真实调用的返回结构（条目内容为示例文章生成）。注意 `list` 是**字符串数组**，每条是短句/关键词式摘要，不是完整段落。
## 进阶 / 边界
- **免费不等于不限次**：实测每次调用 `showapi_fee_num` 为 `1`，即从免费额度扣 1 次，超额需购买资源包（见 [免费 API 说明](https://www.showapi.com/free-api)）。
- **短文本条数可能少于 `num`**：原文太短、信息点不足时，实际返回的 `list` 条数可能小于 `num`（实测短文本 `num=3` 仅返回 1 条）。
- **超时**：服务器读取超时约 5s，长文建议客户端超时设 30s。
## FAQ
**Q1：提示业务失败 `ret_code` 非 0 怎么办？**
A：公开文档只说明「0=成功，其他=失败」，未枚举具体非 0 值。先检查 `text`、`num` 是否都传了、是否为空；仍失败可凭 `showapi_res_id` 联系 [易源客服](mailto:service@showapi.com)。
**Q2：GET 和 POST 用哪个？**
A：推荐 POST。`text` 可能很长，GET 受 URL 长度限制，长文用 POST 更稳。
**Q3：`num` 传数字还是字符串？**
A：按文档与 OpenAPI，`num` 为字符串类型，传 `"3"` 这类字符串即可（实测字符串可正常返回）。
**Q4：免费额度用完了会怎样？**
A：需购买资源包后继续调用，具体档位见 [免费 API 说明](https://www.showapi.com/free-api)。
**Q5：返回的中文乱码？**
A：确认请求/响应用 UTF-8 编码；`--data-urlencode`（cURL）或 `URLSearchParams`（Node）会自动处理中文。
## 相关能力 / 下一步阅读
- [生成文章摘要返回字段全解：showapi_res_body 与 list / ret_code 一文读懂](https://www.showapi.com/guides/article-summary-response-fields-961)
- [生成文章摘要参数详解：text 与 num 的正确用法](https://www.showapi.com/guides/article-summary-params-guide-961)
- **本系列共 8 篇**：查看[生成文章摘要指南总目录](https://www.showapi.com/guides/article-summary-guides-961)
