API 接入指南

把模型接进工作流，从确认接口开始。

选择你的客户端

GUI / CLICodex →桌面版、命令行安装与 API 配置。GUI / CLIClaude →桌面版登录与 Claude Code 接入。配置管理CC Switch →集中管理并切换 API 服务商配置。

控制台入口以交付说明为准。控制台是管理密钥与额度的网页，Base URL 请从实际交付信息中复制。

接入前准备

购买 API 服务后，按交付说明确认以下信息。网页会员订阅不包含 API 使用额度，除非商品页另有说明。

配置项	用途
接口地址（Base URL）	由服务交付说明提供，不是本官网网址
API 密钥	访问已购买的 API 服务
模型标识	请求中实际使用的模型名称
协议与路径	确认 OpenAI 兼容接口或 Claude 对应接口
计费与限额	确认额度、速率限制、上下文范围与计费规则

配置到开发工具

在工具的模型服务设置中填入交付的接口地址、密钥与模型标识。先用不含敏感信息的简单请求验证连接，再启用日常工作流。

下方仅展示环境变量组织方式，示例值必须替换为真实交付信息 ，并非可直接调用的接口。

环境变量示例

export SUPAKOOK_BASE_URL="替换为交付的接口地址"
export SUPAKOOK_API_KEY="替换为你的 API 密钥"
export SUPAKOOK_MODEL="替换为交付的模型标识"

不同工具对 Base URL 是否需要带版本路径的要求不同，以该工具和服务交付说明为准。不要把密钥写入网页前端、公共仓库或截图。

请求兼容与稳定性

服务以对齐官方请求字段和后台容量冗余为目标。字段、工具调用、流式输出及模型版本的实际支持范围，应以所购接口说明为准。

冗余容量不能消除所有中断。网络、官方服务状态、限流与账号状态都可能影响单次请求；生产工作流应设置合理超时、有限次数重试，并保留失败提示。

常见错误排查

• 401 / 403： 检查密钥是否正确、有效，以及是否有对应服务权限。不要向他人发送完整密钥。
• 404： 检查接口路径和模型标识，确认开发工具是否重复添加了版本路径。
• 429： 检查余额、额度和速率限制，降低并发并按服务说明重试。
• 5xx / 超时： 记录发生时间、请求 ID（如有）与脱敏错误信息，避免无限重试。

需要协助时，通过原订单渠道提交产品名称、工具版本和脱敏后的复现步骤。