毒鸡汤接口常见问题与避坑（ret_code -1 / 重复 / 无法选主题）

# 毒鸡汤接口常见问题与避坑（ret_code -1 / 重复 / 无法选主题） > 接口/接入点：毒鸡汤生成（apiCode 2784，接入点 1） · 是否免费：免费（有使用档次限制） · 请求方式：POST/GET · 返回格式：JSON · 适用人群：所有接入者 · 阅读时间：约 5 分钟 ## 核心要点 - 高频问题集中在三类：返回 `ret_code=-1`、连续两句重复、想选主题却选不了。 - 字段名是 `emposion`（非 emotion），取数路径必须含 `showapi_res_body`。 - 本文是独立可搜的避坑页，所有系列文章都链接到这里。 ## Why：把最常被问到的坑集中讲清 接入毒鸡汤的人，90% 的工单都绕不开上面三个问题。把它们一次性讲透，既能让你少踩坑，也方便直接把本文甩给同事/用户。 ## 问题清单与排查 ### 1. 返回 ret_code = -1 查 `showapi_res_body.remark` 的错误信息，常见方向： - **AppKey 问题**：无效/过期/未urlencode → 到[AppKey 管理](https://www.showapi.com/console#/myApp)核对。 - **服务瞬时繁忙**：`remark` 提示"稍后再试" → 参考《5 秒超时下如何做重试与容错？》做有限重试。 - **超频/限流**：免费档位有使用档次限制 → 参考《免费档位下如何控制频次与成本？》。 ### 2. 连续两句一模一样 接口**随机返回且无 ID**，不保证不重复；连发/定时推送必须调用方自建去重（见《随机返回的毒鸡汤如何避免重复？》《每日推送去重设计》）。 ### 3. 想选"职场/催婚/恋爱"主题却做不到 接口 OpenAPI `parameters` 为空，**没有分类/主题/长度入参**，调用即随机返回一句。文档里"覆盖 21 类话题"是内容覆盖面描述，不是可调参数。主题化只能在返回后做关键词过滤或自建话题库（调用方逻辑）。 ### 4. 字段取不到 / 出现 undefined 路径应为 `showapi_res_body.emposion`，字段名是 `emposion`。拼错成 `emotion` 或漏掉外层包裹都会取空（详见《返回字段全解》）。 ## FAQ **Q1：为什么一直返回 ret_code=-1？** 先读 `remark` 字段。若是 AppKey 相关，去控制台核对；若是"服务繁忙/限流"，做有限重试并降低调用频率（免费档位有限制）。不要无差别无限重试。 **Q2：为什么连着两句一样？接口不是每日更新吗？** "每日更新"是后端内容运营动作，不代表每次返回都不同，也不返回判重 ID。调用方需自建去重缓存。详见去重文章。 **Q3：能不能指定要"职场"或"催婚"主题的毒鸡汤？** 不能。接口无分类入参，调用即随机。需要主题化只能在返回后过滤或自建话题库，属于调用方逻辑，非接口能力。 **Q4：免费接口有调用次数限制吗？具体多少？** 有使用档次限制，但官方文档未给出具体数字。请以[官方档位说明](https://www.showapi.com/free-api)为准，不要假设无限。 **Q5：超时一般多久？怎么设？** 官方 read/connect 超时均为 5 秒。代码建议显式设置超时（如 5 秒），超时可按《5 秒超时下如何做重试与容错？》处理。 **Q6：接口支持订阅推送吗？** 不支持。接口是单次同步生成，调用一次返回一句，没有订阅 + 回调机制。 ## 相关能力 / 下一步阅读 - [毒鸡汤生成接口：返回字段全解](https://www.showapi.com/guides/poison-soup-response-2784) —— 字段与状态判断 - [随机返回的毒鸡汤如何避免重复？](https://www.showapi.com/guides/poison-soup-dedup-2784) —— 去重生产级写法 - [免费档位下，如何控制毒鸡汤调用频次与成本？](https://www.showapi.com/guides/poison-soup-free-tier-2784) —— 限流与额度 - **本系列共 14 篇**：查看[毒鸡汤生成接口官方指南总目录](https://www.showapi.com/guides/poison-soup-guides-2784)