# 藏头诗生成：节日祝福藏头诗批量生成实战
> 接口/接入点：藏头诗生成（apiCode=950，接入点 950-1）· 免费 · 返回格式 JSON · 适用人群：活动运营、新媒体、文创 · 阅读时间：8 分钟
## 核心要点
- 接口本身**无批量能力**，批量靠"客户端循环多次调用"实现。
- 为每个收礼人取名字/祝福词作为 `key`，循环生成藏头祝福。
- 免费接口有档次限制，批量前先看成本与缓存策略。
## Why：一份心意，群发给所有人
节日（春节/生日/中秋）常需给一串人送祝福。手工写藏头诗费时，用接口为每位收礼人循环生成一首藏头祝福，再汇成贺卡或群发文案，效率提升明显。
## What：方案速览
| 项目 | 说明 |
|------|------|
| 输入 | 收礼人列表（名字或祝福短句，每项 ≤8 字） |
| 处理 | 遍历列表，每人一次调用，取 `list[0]` 或随机一首 |
| 输出 | 人名→诗句的映射，用于贺卡/海报/文案 |
| 注意 | 接口无批量/订阅，纯同步；高频注意档位限制 |
## How：循环批量生成
以"拜年"为例，给三位朋友各生成一首藏头祝福（key 用其名字）。
**Python**
```python
import requests
url = "https://route.showapi.com/950-1"
params = {"appKey": "YOUR_APPKEY"}
friends = ["小明", "阿强", "丽丽"]
for name in friends:
data = {"num": "5", "type": "1", "yayuntype": "1", "key": name}
try:
r = requests.post(url, params=params, data=data, timeout=30)
body = r.json().get("showapi_res_body", {})
if body.get("ret_code") != "0":
print(f"{name}: 失败 {r.json().get('showapi_res_error')}")
continue
poem = body["list"][0] # 取第一首
print(f"{name} 的藏头祝福：\n{poem}\n")
except requests.RequestException as e:
print(f"{name}: 请求异常 {e}")
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/950-1?appKey=YOUR_APPKEY";
const friends = ["小明", "阿强", "丽丽"];
for (const name of friends) {
const body = new URLSearchParams({ num: "5", type: "1", yayuntype: "1", key: name });
const resp = await fetch(url, { method: "POST", body, signal: AbortSignal.timeout(30000) });
const res = await resp.json();
const b = res.showapi_res_body;
if (b.ret_code !== "0") { console.error(`${name}: 失败`, res.showapi_res_error); continue; }
console.log(`${name} 的藏头祝福：\n${b.list[0]}\n`);
}
```
**cURL（单条）**
```bash
curl -X POST "https://route.showapi.com/950-1?appKey=YOUR_APPKEY" \
-d "num=5&type=1&yayuntype=1&key=%E5%B0%8F%E6%98%8E"
```
## 返回示例与解析
调用 `key=小明` 时，`list` 返回多首，取其一即可：
```
小窗临水静，明月至人来。
```
每人一首，汇成祝福列表即可群发或制卡。
## 进阶 / 边界
- **无批量接口**：必须逐人调用；人数多时注意免费档位限制与超时，详见[免费档位与成本](https://www.showapi.com/guides/cangtoushi-cache-cost-950)。
- **相同 key 可缓存**：同一名字短期内结果可本地缓存，避免重复扣费/限流。
- **key ≤8 字**：名字+祝福词过长会截断，建议只用名字或 2~4 字短词。
## FAQ
**Q1：有没有一次传多人的批量接口？** 没有，本接口为同步单条，批量靠客户端循环。
**Q2：几百人会不会被限流？** 免费有档次限制，量大建议用平台积分兑换更高档位并加适当间隔。
**Q3：每次返回多首，取哪首？** 取 `list[0]` 或随机一首均可，由业务决定。
**Q4：能自动配图吗？** 接口只返回文字，配图需自行用返回诗句结合设计工具实现。
## 相关能力 / 下一步阅读
- [藏头诗生成：免费档位与积分兑换，如何控制调用成本](https://www.showapi.com/guides/cangtoushi-cache-cost-950)
- [藏头诗生成：情书藏头诗，用 key 把心意藏进诗里](https://www.showapi.com/guides/cangtoushi-love-letter-950)
- **本系列共 12 篇**：查看[藏头诗生成指南总目录](https://www.showapi.com/guides/cangtoushi-guides-950)
