接入指南
客户端与接口地址
本页内容
先打开密钥的「连接信息」，再选择客户端使用的协议。优先复制该面板给出的 API 地址。
地址应该怎么填
以下为本站常规分组的地址。特殊分组若在「连接信息」中显示不同路径，以该密钥的面板为准。
| 客户端协议 | Base URL | 完整请求地址 |
|---|---|---|
| OpenAI Chat Completions | https://api.supergpt.win/v1 |
https://api.supergpt.win/v1/chat/completions |
| OpenAI Responses | https://api.supergpt.win/v1 |
https://api.supergpt.win/v1/responses |
| Anthropic Messages | https://api.supergpt.win |
https://api.supergpt.win/v1/messages |
Base URL 和完整请求地址不是同一个字段。 客户端会自动补上接口路径时，填写 Base URL；明确要求完整 Endpoint 时，才填写右侧地址。
如果客户端会自动追加 /v1，地址只填 https://api.supergpt.win。出现 /v1/v1/…、/responses/responses 等重复路径时，调整客户端地址，而不是更换密钥。
通用聊天客户端
- 新增服务商，选择与密钥分组相符的 OpenAI 兼容或 Anthropic 兼容协议。
- 填写 API 地址和本站生成的 API Key。
- 添加模型，粘贴模型广场中的完整模型 ID，不要用分组名或模型昵称。
- 保存后发一条简短消息，确认回复与使用记录。
客户端的「获取模型列表」并不等于调用测试。列表加载失败时，可手动填写模型 ID，再根据实际响应排查。某些客户端只支持 Chat Completions，不能仅修改地址就当作 Responses 客户端使用。
编程助手
- Codex 接入教程：桌面客户端、CLI 和 VS Code／Cursor／Windsurf 官方扩展，使用 OpenAI Responses 协议。
- Claude Code：使用 Anthropic Messages 协议和支持 Claude 的分组。
- 自行开发：API 调用示例。
是否支持图片、工具调用、长上下文或其他参数，取决于具体模型、分组和客户端。先用最小文本请求确认连通，再逐项启用需要的功能。
三个最常见的配置错误
- 将
console.supergpt.win填为 API 地址：这是控制台，调用地址使用api.supergpt.win。 - 密钥、模型来自不同分组：回到该密钥的「查看模型」重新选择。
- 协议与路径不匹配：按照上表和连接信息检查，不要随意添加接口后缀。