藏头诗生成：藏头/藏尾/藏中/递增/递减五种玩法（type 参数全解）
# 藏头诗生成：藏头/藏尾/藏中/递增/递减五种玩法（type 参数全解）
> 接口/接入点：藏头诗生成（apiCode=950，接入点 950-1）· 免费 · 返回格式 JSON · 适用人群：文案、运营、开发者 · 阅读时间：7 分钟
## 核心要点
- `type` 决定"字藏在哪"：1藏头、2藏尾、3藏中、4递增、5递减。
- 每种玩法配合 `key`（要藏的字/句，最多八字）生效。
- 同一 key、不同 type，产出完全不同的诗句结构。
## Why：把字藏在不同位置，效果天差地别
藏头诗不是只能"每句开头"。表白常用藏头（开头亮明心意），签名/落款常用藏尾，创意排版可用藏中、递增、递减。理解 `type` 五种取值，才能按场景选对玩法。
## What：type 参数取值表
| type | 玩法 | 说明 | 典型场景 |
|------|------|------|---------|
| 1 | 藏头 | 每句首字连起来是 key | 表白、祝福开头亮明 |
| 2 | 藏尾 | 每句末字连起来是 key | 签名、落款 |
| 3 | 藏中 | 句中特定位置嵌入 key | 创意排版 |
| 4 | 递增 | 字按递增位置出现 | 特殊韵律效果 |
| 5 | 递减 | 字按递减位置出现 | 特殊韵律效果 |
其余必填参数：`num`（5五言/7七言）、`yayuntype`（1/2/3 押韵）、`key`（最多八字）。
## How：切换 type 生成不同玩法
以 `key=易源接口`、五言、双句一压为例，仅改 `type`：
**Python**
```python
import requests
url = "https://route.showapi.com/950-1"
params = {"appKey": "YOUR_APPKEY"}
for t in ["1", "2", "3", "4", "5"]:
data = {"num": "5", "type": t, "yayuntype": "1", "key": "易源接口"}
r = requests.post(url, params=params, data=data, timeout=30)
body = r.json().get("showapi_res_body", {})
print(f"=== type={t} ===")
for poem in body.get("list", []):
print(poem)
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/950-1?appKey=YOUR_APPKEY";
for (const t of ["1", "2", "3", "4", "5"]) {
const body = new URLSearchParams({ num: "5", type: t, yayuntype: "1", key: "易源接口" });
const resp = await fetch(url, { method: "POST", body, signal: AbortSignal.timeout(30000) });
const res = await resp.json();
console.log(`=== type=${t} ===`);
res.showapi_res_body.list.forEach((p) => console.log(p));
}
```
**cURL（藏尾示例，type=2）**
```bash
curl -X POST "https://route.showapi.com/950-1?appKey=YOUR_APPKEY" \
-d "num=7&type=2&yayuntype=1&key=%E6%98%93%E6%BA%90%E6%8E%A5%E5%8F%A3"
```
## 返回示例与解析
`type=1`、五言、`key=易源接口` 时，每首四句、句首四字依次为"易/源/接/口"：
```
易识浮生理，源发在深空。接叶制茅亭，口眼不相营。
```
`type=2` 时同样四字会出现在每句**末尾**。具体落位以实际返回为准，文档未对藏中/递增/递减逐字位置做文字定义，建议用真实返回观察。
## 进阶 / 边界
- `key` 最多八个字，但诗句单首字数有限（五言每句5字、七言每句7字），key 越长对成诗约束越强、质量可能下降。选词技巧见[key 参数优化](https://www.showapi.com/guides/cangtoushi-key-optimize-950)。
- 想让韵律更顺，配合 `yayuntype` 调整，见[押韵模式怎么选](https://www.showapi.com/guides/cangtoushi-rhyme-guide-950)。
## FAQ
**Q1：type 传错数字会怎样？** 文档仅定义 1~5，传其它值可能返回非 0 或无预期效果，建议严格用 1~5。
**Q2：藏头必须四字吗？** key 最多八字，但单首诗句字数受限，常用 2~4 字效果最佳。
**Q3：能混搭藏头+藏尾吗？** 单次调用只支持一种 type，需多次调用分别生成再自行组合。
**Q4：递增/递减看不出规律？** 文档未给出逐字位置定义，以实际返回观察为准，不臆测位置规则。
## 相关能力 / 下一步阅读
- [藏头诗生成：押韵模式怎么选（yayuntype 双句一压/双句押韵/一三四押）](https://www.showapi.com/guides/cangtoushi-rhyme-guide-950)
- [藏头诗生成：key 参数怎么写效果最好（八字上限与选词技巧）](https://www.showapi.com/guides/cangtoushi-key-optimize-950)
- **本系列共 12 篇**：查看[藏头诗生成指南总目录](https://www.showapi.com/guides/cangtoushi-guides-950)
