棉花糖 API｜统一模型 API 平台

棉花糖 API 把 ChatGPT 订阅账号池化为统一 API：一个密钥、OpenAI 兼容、价格透明、自动调度与故障转移。

适合谁

• 用 CC Switch / Cursor / Codex / Cherry Studio 管理多套 Provider 的开发者
• 用 OpenAI SDK / HTTP 直接调 /v1/chat/completions 的应用
• 希望一个 sk 打通 GPT-5.6 / 5.5 / 5.4 账号池，不想分别管账号的人

三步上手

推荐使用 CC Switch 来导入配置

推荐使用 CC Switch 来导入配置。

CC Switch 是一个跨平台的 AI CLI 配置管理工具，可用于集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的模型提供商（Provider）配置。它把 Base URL、API Key、模型名称等信息统一保存，让你在多个 CLI 工具或多套 Provider 之间一键切换，避免反复修改环境变量或配置文件。

下载安装、一键导入与手动配置的详细步骤见 导入到 CC Switch →。

接入概览

接入信息由三部分组成：Base URL、API Key、模型名称。

OpenAI 兼容接入

不要把 Base URL 写成完整接口路径。例如不要填写 https://api.mallowapi.com/v1/chat/completions。

适合：Codex、Cursor、Cherry Studio，以及其他支持自定义 OpenAI Provider 的客户端。入口可能叫 API Address、Endpoint、Override Base URL 或 Provider URL，本质上都填同一个地址。

快速连通性测试

curl https://api.mallowapi.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

若返回模型列表，说明 OpenAI 兼容接口、Key 与网络基本正常。

推荐：用 CC Switch 管理配置

推荐使用 CC Switch 来导入配置。

CC Switch 是一个跨平台的 AI CLI 配置管理工具，可用于集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的模型提供商（Provider）配置。它把 Base URL、API Key、模型名称等信息统一保存，让你在多个 CLI 工具或多套 Provider 之间一键切换，避免反复修改环境变量或配置文件。

下载安装、一键导入与手动配置的详细步骤见 导入到 CC Switch →。

下一步

• 创建 API Key
• 导入到 CC Switch（推荐）
• 导入到 Cursor
• 导入到 Codex
• 导入到 Cherry Studio

创建 API Key

密钥在控制台发放，可随时吊销。

建议

• 按项目拆分 Key，方便对账与吊销
• 不要把 Key 写进公开仓库或截图
• 泄露后立即在控制台吊销并换新

导入到 CC Switch

推荐使用 CC Switch 来导入配置。

CC Switch 是一个跨平台的 AI CLI 配置管理工具，可用于集中管理 Claude Code、Codex、Gemini CLI、OpenCode 等工具的模型提供商（Provider）配置。它把 Base URL、API Key、模型名称等信息统一保存，让你在多个 CLI 工具或多套 Provider 之间一键切换，避免反复修改环境变量或配置文件。

下载安装

CC Switch 是开源项目，源码托管在 GitHub：farion1231/cc-switch。

一键导入

推荐使用一键导入：一键即可把 Provider 配置直接写入本机 CC Switch，无需手动填写配置信息。

若控制台暂无一键按钮，请使用下方「手动添加 Provider」。

手动添加 Provider

保存后，在 CC Switch 中把 Claude Code / Codex / Gemini CLI / OpenCode 等切换到该 Provider 即可使用。

验证是否生效

curl https://api.mallowapi.com/v1/models \
  -H "Authorization: Bearer sk-your-api-key"

返回模型列表即表示 Base URL、Key 与网络正常。再在对应 CLI 里发一条简单对话即可。

OpenAI SDK

改一行 base_url，其余照官方文档。

# pip install openai
from openai import OpenAI

client = OpenAI(
    base_url="https://api.mallowapi.com/v1",
    api_key="sk-xxxx",
)

resp = client.chat.completions.create(
    model="gpt-5.4",
    messages=[{"role": "user", "content": "hello"}],
)
print(resp.choices[0].message.content)

curl https://api.mallowapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.4",
    "messages": [{"role": "user", "content": "hello"}]
  }'

流式：请求体加 "stream": true，SSE 原样透传。

导入到 Cursor

在 Cursor 中添加自定义 OpenAI 兼容 Provider。

导入到 Codex

CLI / 配置文件中指向本站 OpenAI 兼容端点。

export OPENAI_BASE_URL=https://api.mallowapi.com/v1
export OPENAI_API_KEY=sk-xxxx
# 再按 Codex 官方方式启动，model 选 gpt-5.4

导入到 Cherry Studio

添加 OpenAI 兼容供应商。

模型列表

主打 ChatGPT 账号池。可用型号以控制台实际可调度为准。

路由与故障转移

上游倒下时，你的请求不断流。

• 健康检查——持续探测上游可用性与延迟
• 负载均衡——在健康上游间分配请求
• 自动切换——429 / 掉线时改道健康节点
• 会话保持——多轮对话尽量固定同一上游；可用性优先于粘性

密钥与配额

发放、吊销、配额上限都在控制台。

• 密钥加密存储，不落明文日志
• 可随时吊销，立即生效
• 配额用尽返回 429，不继续扣费

计费方式

统一模型 API 平台：按 Token 计费 · 透明可查。

• 按量扣费——输入 / 输出 / 缓存读写分别计价
• 分组定价——GPT Codex 标准 0.15x，表内现价 + 原价对照
• 无月租——$0 月最低消费，预充值后按量使用
• 明细——控制台按模型、时间查看消耗

模型定价

单位：每百万 Token（USD）。缓存列同为 $/MTok。现价 = 官方原价 × 折扣。

GPT Codex - 标准 0.15x

支持 Codex 客户端，也支持第三方客户端；支持 image-2 生成图片。日常使用选这一档即可。

常见问题

接入与计费高频问题。

Base URL 要不要带 /chat/completions？

不要。只填 https://api.mallowapi.com/v1，客户端会自己拼路径。

密钥安全吗？

加密存储，不落明文日志。可随时吊销。

和直连官方有什么区别？

多上游调度 + 故障转移 + 统一账单。当前标准线路价格透明可查。

配额用完会怎样？

返回 429，不继续扣费。上调后即恢复。

没找到答案？contact →

常见错误