Image generation is not enabled for this group 报错 - CC Switch
Quick fix
当前需手动过滤生图请求或配置本地桥接进程读取响应头,官方正推进相关功能以彻底解决 403 阻断问题。
Symptom
Section titled “Symptom”status_code=403, Image generation is not enabled for this group该问题主要由两类中转站(Relay)限制引起。其一,新版 Codex 等工具默认携带生图参数发起对话,但多数中转站不支持直接调用生图接口,导致上游返回 403 并提示生图未启用。
其二,部分中转站(如 LiteLLM Proxy)发放受限虚拟密钥,仅允许调用推理路由,管理/计费类接口(如 /key/info)会被直接拦截返回 403。对于此类密钥,额度信息仅存在于普通推理请求的 HTTP 响应头中;而 CC Switch 当前逻辑会在调用用量查询 extractor 前检查状态码,遇到非 2xx 响应即中止并丢弃响应头,导致纯脚本无法获取额度数据。目前社区尚未形成统一修复方案,#4938 建议增加生图过滤开关,#5227 则提议让 extractor 支持读取响应头,两者方向不同且均未合入主干。
若使用支持生图过滤的中转站,请在 cc-switch 配置中开启生图参数过滤选项,避免向不支持的模型发送图像生成指令。
针对受限密钥导致的额度查询 403,可部署一个本地桥接进程:由该进程发送探针请求、读取 HTTP 响应头中的额度字段,并将其转换为 JSON body 重新提供给 CC Switch 进行查询,以此绕过原生提取器的限制。
Affected Versions
Section titled “Affected Versions”ToolCodex / Claude Code
Version未知
Platforms未知
Source Issues
Section titled “Source Issues”本页汇总自 1 个真实 issue
- 为什么开启本地代理后仍然报 403?
- 因为部分中转站的 403 错误发生在推理接口本身(例如生图参数不被支持)或管理接口被密钥权限限制。本地代理仅负责流量转发,无法修改上游网关的鉴权逻辑或参数校验规则。
- 如何在不运行后台进程的情况下查看受限密钥的剩余额度?
- 当前版本 CC Switch 会在非 2xx 响应时直接中断并丢弃响应头,因此无法直接读取。需等待官方合并响应头透传功能(参考 #5227),或暂时使用本地桥接脚本将响应头数据持久化为 JSON 供提取器读取。
这是一个非官方社区 wiki,与 cc-switch 作者及项目本身无隶属关系。内容整理自项目公开的 GitHub issues。本站不分发任何软件。