# 免费档位下，如何控制毒鸡汤调用频次与成本？
> 接口/接入点：毒鸡汤生成（apiCode 2784，接入点 1） · 是否免费：免费（有使用档次限制） · 请求方式：POST/GET · 返回格式：JSON · 适用人群：已接入用户、运维/后端 · 阅读时间：约 5 分钟
## 核心要点
- 接口**免费但设有使用档次限制**，具体额度以[官方档位说明](https://www.showapi.com/free-api)为准，本文不臆造数字。
- 每一次成功/失败的接口调用都计入调用次数；重试、去重避让重试同样消耗额度。
- 控频三板斧：本地缓存去重（跳过无效调用）、前端节流、失败不计费判断（`showapi_fee_num`）。
## Why：免费不等于随便调
免费接口的"档位限制"是防滥用的护栏。一旦超过，轻则限流、重则当天不可用。做推送、批量取句、群聊高并发时，不加控制很容易把额度一天烧完。本篇讲清楚"怎么省着用"。
## What：计费与档位事实
| 项目 | 说明 |
|------|------|
| 计费模式 | 免费，注册后默认可调用 |
| 限制 | 有使用档次限制（防止滥用） |
| 额度数字 | 文档未给出，**以[官方档位说明](https://www.showapi.com/free-api)为准** |
| 计费字段 | 返回体含 `showapi_fee_num`（本次调用计费次数，免费接口通常为 0） |
## How：控频与省额度实践
### 1) 用缓存减少真实调用
去重命中 / 内容复用直接走缓存，跳过接口调用（详见《随机返回的毒鸡汤如何避免重复？》）。
### 2) 前端/网关节流
```javascript
// 前端"再来一句"按钮节流示例（800ms 内只允许一次）
let lastCall = 0;
async function onMore() {
const now = Date.now();
if (now - lastCall < 800) return;
lastCall = now;
// 调用接口...
}
```
### 3) 失败不计费判断
```python
body = resp.json().get("showapi_res_body", {})
fee = resp.json().get("showapi_fee_num", 0)
if body.get("ret_code") == 0:
print(body.get("emposion"))
else:
# 失败多半不计费，但以保护逻辑为准，不要靠重试"赌"成功
print("失败：", body.get("remark"), "本次计费次数:", fee)
```
## 返回示例（含计费字段）
```json
{
"showapi_res_code": 0,
"showapi_fee_num": 0,
"showapi_res_body": { "ret_code": 0, "remark": "", "emposion": "存款是成年人唯一的底气。" }
}
```
## 进阶/边界
- **额度数字不编**：官方未公开具体次数/QPS，任何"每天 N 次"的说法都需以[官方档位说明](https://www.showapi.com/free-api)为准。
- **重试也是消耗**：《5 秒超时下如何做重试与容错？》里的重试、去重避让都会吃额度，上限要克制。
- **批量场景预估**：日推送 N 条 ≈ N 次调用 + 去重避让次数；上线前按档位做容量核对。
## FAQ
**Q1：免费接口每天到底能用多少次？**
官方文档未给出具体数字，请以来源[官方档位说明](https://www.showapi.com/free-api)为准，不要凭印象假设无限。
**Q2：调用失败会扣额度吗？**
返回体含 `showapi_fee_num` 表示本次计费次数（免费接口通常为 0），以实际返回为准，不要假设"失败必不计费"或"失败必计费"。
**Q3：被限流了怎么办？**
先核对是否超过档位；做前端节流、本地缓存去重、降低重试上限；确有更大需求看官方档位/付费说明。
## 相关能力 / 下一步阅读
- [随机返回的毒鸡汤如何避免重复？](https://www.showapi.com/guides/poison-soup-dedup-2784) —— 缓存去重省额度
- [毒鸡汤接口 5 秒超时下，如何做重试与容错？](https://www.showapi.com/guides/poison-soup-timeout-retry-2784) —— 克制重试
- [毒鸡汤接口常见问题与避坑](https://www.showapi.com/guides/poison-soup-faq-2784) —— 失败排查全集
- **本系列共 14 篇**：查看[毒鸡汤生成接口官方指南总目录](https://www.showapi.com/guides/poison-soup-guides-2784)
