SosoGPT API 文档

1. 快速开始

主线路地址：

https://api.sosogpt.com

OpenAI 兼容 Base URL：

https://api.sosogpt.com/v1

常用接口：

2. 创建和使用 API Key

1. 登录控制台。
2. 进入「令牌管理」。
3. 创建新的 API Key，并选择需要使用的分组。
4. 保存 API Key。完整 Key 通常只显示一次。

请求时需要携带以下 Header：

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

不要在前端网页、公开仓库或客户端安装包中暴露 API Key。泄露后请立即删除并重新创建。

3. 查看模型

不同令牌分组可能看到不同的模型列表。建议先用当前 API Key 查询可用模型：

curl https://api.sosogpt.com/v1/models \
  -H "Authorization: Bearer YOUR_API_KEY"

模型名称必须与接口返回的名称完全一致，包括大小写、横线和版本号。

4. 调用示例

Chat Completions

curl https://api.sosogpt.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {
        "role": "user",
        "content": "你好，用一句话介绍你自己"
      }
    ],
    "stream": false
  }'

流式输出

curl https://api.sosogpt.com/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4-mini",
    "messages": [
      {
        "role": "user",
        "content": "写一段 100 字以内的产品介绍"
      }
    ],
    "stream": true
  }'

Node.js SDK

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.SOSOGPT_API_KEY,
  baseURL: "https://api.sosogpt.com/v1",
});

const completion = await client.chat.completions.create({
  model: "gpt-5.4-mini",
  messages: [{ role: "user", content: "你好，请介绍一下你自己" }],
});

console.log(completion.choices[0].message.content);

Python SDK

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_API_KEY",
    base_url="https://api.sosogpt.com/v1"
)

response = client.chat.completions.create(
    model="gpt-5.4-mini",
    messages=[
        {"role": "user", "content": "你好，请介绍一下你自己"}
    ]
)

print(response.choices[0].message.content)

5. Codex CLI 和 Claude Code

以下示例使用本站地址接入。请先在控制台创建 API Key，并确认该 Key 所属分组已经开放对应模型。

CLI 前置环境

Codex CLI 和 Claude Code 都需要先准备 Node.js 与 npm。建议使用当前 LTS 版本。

node -v
npm -v

如果本机还没有 Node.js，Linux 或 macOS 可以使用 nvm 安装：

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
source ~/.bashrc
nvm install --lts
nvm use --lts
node -v
npm -v

Windows 用户可以在 PowerShell 中运行：

winget install -e --id OpenJS.NodeJS.LTS
node -v
npm -v

如果使用 WSL，也可以在 WSL 里使用上面的 nvm 方式安装。

Codex CLI

Codex 推荐使用 OpenAI Responses 协议。先确认 npm 可用：

node -v
npm -v

安装或更新官方 CLI：

npm i -g @openai/codex
codex --version

创建配置目录和文件：

mkdir -p ~/.codex
chmod 700 ~/.codex

使用编辑器创建或编辑 ~/.codex/config.toml：

model_provider = "sosogpt"
model = "gpt-5.5"
model_reasoning_effort = "medium"
disable_response_storage = true
cli_auth_credentials_store = "file"

[model_providers.sosogpt]
name = "SosoGPT"
base_url = "https://api.sosogpt.com/v1"
wire_api = "responses"
requires_openai_auth = true

当前 Codex Base URL：

https://api.sosogpt.com/v1

使用编辑器创建或编辑 ~/.codex/auth.json，并将 YOUR_API_KEY 替换为你在本站控制台创建的 API Key：

{
  "OPENAI_API_KEY": "YOUR_API_KEY"
}

启动 Codex：

codex

也可以临时指定模型：

codex -m gpt-5.5
codex -m gpt-5.4-mini

提供商、鉴权和 Base URL 应放在 ~/.codex/config.toml。项目内 .codex/config.toml 不适合保存这些配置。

Claude Code

Claude Code 使用 Anthropic 协议，不是 OpenAI Chat Completions 协议。本站已提供 Claude Code 可用的 Anthropic 兼容入口。

先确认 npm 可用：

node -v
npm -v

安装或更新 Claude Code：

npm i -g @anthropic-ai/claude-code
claude --version

创建配置目录和文件：

mkdir -p ~/.claude
chmod 700 ~/.claude

使用编辑器创建或编辑用户级 ~/.claude/settings.json，并将 YOUR_API_KEY 替换为你在本站控制台创建的 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "YOUR_API_KEY",
    "ANTHROPIC_BASE_URL": "https://api.sosogpt.com"
  }
}

当前 Claude Code Base URL：

https://api.sosogpt.com

启动 Claude Code：

claude

Claude Code 需要使用 Claude/Anthropic 兼容模型名。若某个分组没有开放 Claude 模型，或模型名不是该分组返回的名称，Claude Code 会报模型不可用或请求失败。

不要把包含密钥的 settings.json 提交到公开仓库。团队项目需要共享配置时，应避免在项目级配置里写入真实 API Key。

使用 CC Switch 管理令牌

如果你经常切换 Claude Code、Codex 或多个 API Key，建议使用 CC Switch 管理 provider 和令牌，避免反复手动编辑配置文件。

下载地址：

https://github.com/farion1231/cc-switch/releases

选择安装包：

• Windows：优先选择 CC-Switch-v{version}-Windows.msi；不想安装可选 Windows-Portable.zip。
• macOS：优先选择 CC-Switch-v{version}-macOS.dmg；也可以使用 Homebrew 安装。
• Linux：Ubuntu / Debian 选择 Linux.deb，Fedora / RHEL / openSUSE 选择 Linux.rpm，通用方式选择 Linux.AppImage。

添加配置有两种方式，推荐优先使用自动导入。

自动导入 CC Switch 配置

1. 先在本站控制台进入「令牌管理」。
2. 创建一个用于本地客户端的 API Key，并选择需要使用的令牌分组。
3. 在该令牌右侧找到「聊天」按钮。
4. 点击「聊天」右侧的下拉菜单，选择 CC Switch。
5. 浏览器会唤起 CC Switch，并自动导入本站地址、令牌和 provider 配置。
6. 在 CC Switch 中确认当前启用的是 SosoGPT provider，然后回到对应客户端继续使用。

手动添加 CC Switch 配置

如果自动导入不可用，可以在 CC Switch 中手动添加或编辑 provider：

保存后点击切换或启用该 provider，再回到对应客户端运行：

claude
codex

如果切换后仍然走旧配置，关闭相关客户端的所有终端窗口后重新打开，再确认 CC Switch 当前启用的是 SosoGPT provider。

6. 分组与计费

SosoGPT 使用令牌分组控制模型范围、路由和计费倍率。不同分组可能对应不同线路、模型和价格。

实际消耗通常与以下因素有关：

• 模型倍率
• 分组倍率
• 输入 tokens 和输出 tokens
• 缓存 tokens
• 模型能力和上游线路成本

模型市场展示价格用于参考，最终扣费以控制台「使用日志」为准。

7. 常见错误

排查问题时，请保留 Request ID、模型名称、请求时间和错误信息。