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（如有）与脱敏错误信息，避免无限重试。
需要协助时，通过原订单渠道提交产品名称、工具版本和脱敏后的复现步骤。