藏头诗生成：key 参数怎么写效果最好（八字上限与选词技巧）
# 藏头诗生成：key 参数怎么写效果最好（八字上限与选词技巧）
> 接口/接入点：藏头诗生成（apiCode=950，接入点 950-1）· 免费 · 返回格式 JSON · 适用人群：文案、开发者、文创 · 阅读时间：6 分钟
## 核心要点
- `key` 是"要藏入诗句的字/句"，**最多八个字**，超长会被截断或削弱成诗质量。
- 单字、词语、短句对成诗约束不同：越短越自由、越长越受限。
- 文档仅提及"选词、押韵、褒贬优先"，未给相关控制参数，本文只讲 key 的边界与经验。
## Why：key 写得好，诗才出得来
`key` 直接决定藏字位置与成诗难度。key 太长或生僻，模型难圆，诗句易生硬；key 精简到位，产出更自然。理解边界能少走弯路。
## What：key 的硬约束与影响
| 维度 | 事实 |
|------|------|
| 长度上限 | 最多八个字（文档明文） |
| 单首字数 | 五言每句5字、七言每句7字，key 越长对诗句约束越强 |
| 位置由 type 决定 | 藏头/藏尾/藏中/递增/递减，key 字按 type 落位 |
| 褒贬优先 | 文档提及"褒贬优先"特性，但未给对应参数，不可在代码中臆造 |
## How：选词实践
经验上，2~4 字的核心词效果最稳。下面演示不同长度 key 的调用（仅改 key）：
**Python**
```python
import requests
url = "https://route.showapi.com/950-1"
params = {"appKey": "YOUR_APPKEY"}
for key in ["易源", "易源接口", "易源数据好"]: # 由短到长
data = {"num": "5", "type": "1", "yayuntype": "1", "key": key}
r = requests.post(url, params=params, data=data, timeout=30)
body = r.json().get("showapi_res_body", {})
print(f"key={key} ->", body.get("list", ["(失败)"])[0] if body.get("ret_code") == "0" else "(失败)")
```
**Node.js（fetch）**
```javascript
const url = "https://route.showapi.com/950-1?appKey=YOUR_APPKEY";
for (const key of ["易源", "易源接口", "易源数据好"]) {
const body = new URLSearchParams({ num: "5", type: "1", yayuntype: "1", key });
const resp = await fetch(url, { method: "POST", body, signal: AbortSignal.timeout(30000) });
const res = await resp.json();
const b = res.showapi_res_body;
console.log(`key=${key} ->`, b.ret_code === "0" ? b.list[0] : "(失败)");
}
```
## 返回示例与解析
- `key=易源`（2字）：约束最小，诗句最自然。
- `key=易源接口`（4字）：常见推荐长度，兼顾藏字与可读性。
- `key=易源数据好`（5字）：约束增强，成诗自由度下降，质量可能波动。
> 具体产出以实际返回为准；文档未承诺"质量评分"等量化指标。
## 进阶 / 边界
- 不臆造参数：文档无"褒贬/选词"控制字段，代码中不要加文档没有的参数。
- 七言（num=7）比五言（num=5）单句更长，藏更长 key 时更从容。
- 想组合韵律，配合 `yayuntype`，见[押韵模式怎么选](https://www.showapi.com/guides/cangtoushi-rhyme-guide-950)。
## FAQ
**Q1：key 超过八字会怎样？** 文档上限八字，超出可能被截断或影响成诗，建议控制在 2~4 字最佳。
**Q2：能用标点符号吗？** key 为要藏入的"字"，建议用纯汉字，标点可能干扰成诗。
**Q3：有"褒义优先"开关吗？** 文档仅提及该特性，未给参数，无法在请求中控制。
**Q4：英文/数字能藏吗？** 文档以中文诗句为主，未说明支持非汉字 key，建议用中文。
## 相关能力 / 下一步阅读
- [藏头诗生成：藏头/藏尾/藏中/递增/递减五种玩法（type 参数全解）](https://www.showapi.com/guides/cangtoushi-acrostic-tail-950)
- [藏头诗生成：情书藏头诗，用 key 把心意藏进诗里](https://www.showapi.com/guides/cangtoushi-love-letter-950)
- **本系列共 12 篇**：查看[藏头诗生成指南总目录](https://www.showapi.com/guides/cangtoushi-guides-950)
