接入指南
API 调用示例
本页内容
以下示例使用 Bash / Zsh 与 curl。先选择协议对应的密钥和模型，替换占位符；每次成功调用都可能产生费用。
准备变量
export SUPERGPT_API_KEY='YOUR_SUPERGPT_API_KEY'
请求体中的 YOUR_MODEL_ID 或 YOUR_CLAUDE_MODEL_ID，应替换为当前密钥分组中的完整模型 ID。切换协议时，同步检查密钥、分组和模型权限。
OpenAI Responses
curl --fail-with-body --silent --show-error \
'https://api.supergpt.win/v1/responses' \
-H "Authorization: Bearer $SUPERGPT_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "YOUR_MODEL_ID",
"input": "请用一句话介绍你自己。",
"stream": true,
"store": false
}' --no-buffer
这是流式示例，返回内容按 SSE 事件逐段到达，不是一个完整的 JSON 文档。客户端需要按事件解析，不能直接对整个响应调用 JSON.parse。
OpenAI Chat Completions
curl --fail-with-body --silent --show-error \
'https://api.supergpt.win/v1/chat/completions' \
-H "Authorization: Bearer $SUPERGPT_API_KEY" \
-H 'Content-Type: application/json' \
--data '{
"model": "YOUR_MODEL_ID",
"messages": [{"role": "user", "content": "你好，请简短回复。"}],
"stream": false
}'
返回成功 JSON 后，从 choices 中读取消息内容。若分组不支持此协议，改用「连接信息」提供的协议，而不是仅修改请求路径。
Anthropic Messages
curl --fail-with-body --silent --show-error \
'https://api.supergpt.win/v1/messages' \
-H "x-api-key: $SUPERGPT_API_KEY" \
-H 'anthropic-version: 2023-06-01' \
-H 'Content-Type: application/json' \
--data '{
"model": "YOUR_CLAUDE_MODEL_ID",
"max_tokens": 128,
"messages": [{"role": "user", "content": "你好，请简短回复。"}]
}'
成功响应包含 content 内容块。max_tokens 是本次输出上限，支持范围以模型实际响应为准。
接到自己的程序
使用兼容 SDK 时，同样设置自定义 Base URL 与本站 API Key，路径规则见客户端与接口地址。先跑通最小文本请求，再加入图片、工具或其他参数。
密钥应放在服务端环境变量或密钥管理服务中，不要嵌入浏览器 JavaScript、手机应用安装包或公开仓库。网页应用通过自己的服务端调用。
处理失败和重试
保存 HTTP 状态码、错误正文、发生时间和响应中可用的请求编号。遇到 401、403 或参数错误时，修正配置后再试；遇到 429 或临时 5xx 时，降低并发、等待后有限重试。
超时或流式中断并不一定表示上游没有处理请求。重复提交可能产生新的调用和费用，先检查使用记录，再决定是否重试。详细对照表见故障排查。