iKun API 常见错误排查

本页整理 iKun API 使用过程中常见的报错、原因和处理方法。遇到问题时，可以先根据状态码或报错关键词定位对应章节。

• iKun API 站点：https://api.monkey-tools.cn
• 图片生成站点：https://img.monkey-tools.cn
• OpenAI 服务状态：https://status.openai.com

请勿公开完整的 API Key。反馈问题时，建议同时提供请求时间、模型、令牌分组和脱敏后的 Request ID。

快速定位

• 401 Unauthorized / Invalid token：优先检查 API Key。
• 403 Forbidden：优先检查令牌分组、令牌额度上限或预扣费额度。
• 429 Too Many Requests：请求频率过高，或上游暂时限流。
• 503 / No available channel：当前分组没有可用渠道，或上游正在调整。
• Stream / Transport / High demand / At capacity：通常是网络、上游负载或模型容量问题。
• gpt-image-2 / b64_json：优先检查生图分组、调用工具和 Base64 返回设置。

当前分组无可用渠道

报错信息

No available channel for model gpt-5.3-codex under group default (distributor) (request id: XXXXX)

原因

令牌绑定的分组与所调用的模型不匹配。令牌、模型和分组必须属于可用的组合。

处理方法

1. 进入平台的“令牌管理”。
2. 找到当前使用的令牌并检查绑定分组。
3. 将令牌修改到支持目标模型的分组。
4. 保存后重新发起请求。

修改为可用分组：

gpt-image-2 无可用渠道

报错信息

Failed after 3 attempts. Last error: 分组 OpenAI 1倍率下模型 gpt-image-2 无可用渠道 (distributor) (request id: XXXXX)

原因

该错误常见于 Cherry Studio 调用 gpt-image-2 时，当前令牌没有绑定支持生图模型的分组。

处理方法

进入“令牌管理”，将当前令牌绑定到支持 gpt-image-2 的生图分组，然后重新测试。

Codex 无法调用 gpt-image-2

报错信息

The 'gpt-image-2' model is not supported when using Codex with a ChatGPT account.

原因

该错误一般出现在平台“操练场”调用 gpt-image-2 时。上游会校验部分请求头，当前 Codex 或 ChatGPT 账户调用方式不符合生图接口要求。

处理方法

改用支持该生图接口的客户端，例如 Cherry Studio，或直接使用本站的图片生成站点。

令牌无权访问指定分组

报错信息

unexpected status 403 Forbidden: 无权访问 "OpenAI 0.9倍率" 分组 (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses

原因

平台价格或分组配置调整后，令牌原来绑定的分组可能已经不可用。

处理方法

进入“令牌管理”，重新选择当前可用的令牌分组并保存，然后开启新会话测试。

503：模型无可用渠道

报错信息

unexpected status 503 Service Unavailable: No available channel for model gpt-5.5 under group OpenAI 0.7倍率 (distributor) (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses

原因

当前模型在所选分组下暂时没有可用渠道。常见原因包括分组调整、渠道维护或上游临时不可用。

处理方法

1. 检查令牌绑定的分组是否仍然支持该模型。
2. 临时切换其他可用分组或模型。
3. 如果持续出现，携带报错信息联系站长确认渠道与分组配置。

压缩任务预扣费失败

报错信息

Error running remote compact task: unexpected status 403 Forbidden: 预扣费额度失败, 用户剩余额度: $23.231908, 需要预扣费额度: $43.091198 (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses/compact

可能原因

1. 当前余额不足以完成上下文压缩任务的预扣费检查。预扣金额不等于最终实际扣费。
2. 上游渠道暂时不支持 gpt-5.5-openai-compact 或 gpt-5.4-openai-compact 压缩模型。

处理方法

1. 补充余额，使其满足预扣费要求；或者开启新会话，避免立即执行上下文压缩。
2. 如果余额充足仍然报错，将完整报错和截图发给站长确认上游压缩模型状态。
3. 可以适当降低上下文窗口，例如先调整到 500K，修改后彻底重启 Codex 并派生新会话。

下面保留站长当前使用的 1M 配置示例：

model_provider = "OpenAI"
model = "gpt-5.5"
model_reasoning_effort = "high"
disable_response_storage = true

model_context_window = 1000000
model_auto_compact_token_limit = 900000

[model_providers.OpenAI]
name = "OpenAI"
base_url = "https://api.monkey-tools.cn/v1"
wire_api = "responses"
requires_openai_auth = true

401：API Key 无效

报错信息

unexpected status 401 Unauthorized: Invalid token (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses

原因

API Key 填写错误、已经失效，或者误用了其他平台的密钥。

处理方法

1. 从 iKun API 的“令牌管理”重新复制正确的 API Key。
2. 检查是否包含多余空格、引号或换行。
3. 保存配置后彻底重启 Codex、VS Code 或其他客户端。
4. 开启新会话重新测试。

流式响应提前断开

报错信息

stream disconnected before completion: stream closed before response.completed

原因

上游服务重启、链路波动或连接在响应完成前被关闭。

处理方法

通常等待片刻后即可恢复。可以在当前会话发送“继续”重试；如果长时间没有恢复，请加入 QQ 群 693655685 获取最新信息。

上游高负载

报错信息

We're currently experiencing high demand, which may cause temporary errors.

原因

模型官方或上游渠道处于高峰期，服务可能出现拥挤、超时或临时失败。

处理方法

• 在当前会话发送“继续”重试。
• 等待片刻后重新请求。
• 临时切换其他模型，例如从 GPT 切换到 Claude。平台中的 GPT 与 Claude 渠道相互隔离，一方异常时可以使用另一方继续工作。

429：请求频率过高

报错信息

exceeded retry limit, last status: 429 Too Many Requests

原因

短时间内请求次数过多，或者上游模型暂时触发限流。该错误不一定代表 iKun API 平台主动限制了你的令牌。

处理方法

稍等片刻，在当前会话发送“继续”重试。避免短时间内重复提交相同任务；如果持续出现，可以临时切换模型或分组。

403：令牌额度不足

报错信息

unexpected status 403 Forbidden: token quota is not enough, token remain quota: $0.007218, need quota: $0.052694 (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses

原因

这通常不是账户总余额欠费，而是当前令牌设置的额度上限太小，令牌剩余额度不足以完成本次请求。

处理方法

进入平台“令牌管理”，提高该令牌的额度上限并保存，然后重新请求。

网络响应解析失败

报错信息

stream disconnected before completion: Transport error: network error: error decoding response body

原因

NGINX、上游服务或网络链路临时异常，导致响应体没有完整传输。

处理方法

客户端一般会自动重连。如果会话中断，可以发送“继续”恢复任务；持续失败时等待站长完成网关或上游服务恢复。

渠道亲和性绑定失效

报错信息

unexpected status 403 Forbidden: The channel selected by channel affinity has been disabled, and retry was stopped by rule. Please contact the administrator (request id: XXXXX), url: https://api.monkey-tools.cn/v1/responses

原因

当前会话通过渠道亲和性绑定到某个上游渠道，但该渠道后来被禁用。常见情况是上游账号异常或渠道临时下线。

处理方法

• 在当前会话发送“继续”，等待平台完成渠道修复。
• 开启新会话，让请求重新选择可用渠道。
• 临时更换令牌分组，使用其他可用的上游渠道。

生图响应无法解析

报错信息

invalid character 'e' looking for beginning of value

原因

该错误常见于平台“操练场”调用 gpt-image-2。接口返回图片时使用 Base64 数据，字段为 b64_json，但当前工具仍按普通 JSON 或图片 URL 方式解析。

处理方法

在生图工具设置中开启“返回 Base64 图片数据”，或者改用图片生成站点。

模型容量已满

报错信息

Selected model is at capacity. Please try a different model.

原因

可能1：OpenAI 当前你用的模型负载已满，暂时无法继续接收请求。
可能2：上游号池 当前你用的模型负载已满，暂时无法继续接收请求。

处理方法

• 等待片刻后发送“继续”重试。
• 临时切换其他模型。
• 查看 OpenAI 服务状态 作为参考。状态页的信息可能晚于实际故障发生时间。

仍然无法解决

联系站长或在 QQ 群 693655685 反馈时，请提供：

1. 完整报错文本或截图。
2. 报错发生时间。
3. 使用的模型和令牌分组。
4. 使用的客户端及版本。
5. 脱敏后的 Request ID。