功能参考
客户端接入
客户端接入的核心是把本地工具的 Base URL 和 API Key 切到 Pixel API。推荐使用 CC-Switch 统一管理 Codex、Claude Code、VS Code 插件和 CLI 的配置。
准备工作
- 打开站点并登录：https://ai-pixel.online。
- 在“API 密钥”页面创建一个 API Key。
- 分组选择你有权限、页面显示可用的
XXX 共享分组；如果有私有账号，也可以把私有分组放进优先级路由。 - 获取并启动 CC-Switch。若无法访问外部下载地址，可从用户群文件获取对应版本。
接入 Codex 或 GPT 系列客户端
- 在 Pixel API 站点打开“API 密钥”。
- 创建密钥，选择适合的共享号池分组。
- 点击“导入到 CCS”，浏览器会唤起 CC-Switch。
- 在 CC-Switch 中确认导入，并启用刚导入的 API 服务。
- 在 Codex、VS Code 插件或 CLI 中切换模型。
推荐模型映射：
| 场景 | 建议 |
|---|---|
| Codex 日常使用 | gpt-5.5 |
| 需要更大上下文 | gpt-5.4 |
| 测试连通性 | 使用站点支持的轻量模型 |
如果导入后没有立即生效，先完全退出客户端再重新进入。只关闭窗口不一定会刷新配置。
接入 Claude Code 使用 GPT 模型
- 在 CC-Switch 切换到 Claude 配置页。
- 点击新增，填入 Pixel API 的 Base URL 和 API Key。
- 打开高级选项，找到模型映射。
- 将 Claude 侧模型映射到
gpt-5.5或gpt-5.4。 - 启用配置，并重启 Claude Code 或 VS Code 插件会话。
Claude 客户端会继续显示 Claude 风格的模型名称，这是客户端展示逻辑；实际请求会按模型映射转发到 Pixel API。
多分组路由
多分组路由适合不想被某个号池短暂不可用打断工作的场景。启用后，请求会按优先级依次尝试不同分组。
示例策略：
- 优先调用低成本
XXX 共享分组。 - 失败后调用主力
XXX 共享分组。 - 仍失败则回落到
XXX 兜底分组。 - 约 30 秒后重新尝试高优先级号池。
优先级数字越小，调度顺序越靠前。私有号池也可以放入多分组路由中，用来优先调用自己的账号。
Claude 系列模型
Pixel API 也可以代理 Claude AWS 渠道模型。使用前请注意：
- Claude 系列单次调用成本通常高于 GPT 系列。
- 创建 API Key 时应选择 Claude 对应兜底分组。
- 当前不建议为 Claude 分组开启多分组路由。
- 导入 CC-Switch 后余额查询失败属于正常现象，不影响模型调用。
配置完成后，打开 Claude Code 或 Claude Code VS Code 插件即可使用对应模型。已有活跃会话需要重启才能应用新配置。