401
密钥没填全、填错或已停用。到控制台核对，复制时不要带空格。
三步接入，
改一行就能用。
棉花糖 API 和 OpenAI 的接口格式一样。你只需要换掉两样东西：请求地址和密钥。下面按你用的工具，一步步说清楚。
按你的工具来
选一个，照着做完就能用。
- 最省事：登录控制台，打开左侧「接入部署」，选 Codex CLI 或 Codex 桌面版，把页面给出的安装指令粘贴到终端运行。指令会自动写好密钥和默认模型。
- 想自己写配置：需要 Codex 0.134.0 或更新版本。在 ~/.codex/config.toml 末尾加上 Provider，再新建同目录的 mallow.config.toml。
[model_providers.mallow]
name = "Mallow API"
base_url = "https://api.mallowapi.com/v1"
env_key = "MALLOW_API_KEY"
wire_api = "responses"model_provider = "mallow"
model = "gpt-6-sol"export MALLOW_API_KEY="sk-你的密钥"
codex --profile mallow- 先从 CC Switch 的 Releases 页面装好并打开一次。
- 在控制台「API 密钥」页，找到要用的那把密钥，点这一行的「导入到 CCS」，浏览器询问时选允许。GPT 分组导入成 Codex 供应商，grok 分组导入成 Grok Build 供应商。
- 在 CC Switch 里确认模型（例如 gpt-6-sol 或 grok-4.7），然后切换到它。
- 手动添加时：请求地址填 https://api.mallowapi.com/v1，上游格式选 Responses。
- 设置 → 模型服务 → 添加，提供商类型选 OpenAI。
- API 密钥填控制台创建的 sk-…；API 地址填 https://api.mallowapi.com（不要带 /v1，Cherry Studio 会自动补上）。
- 点「管理」拉取模型列表，或手动添加 gpt-6.1-sol、gpt-6-luna 等模型 ID，再点「检查」测试连通。
https://api.mallowapi.com- Cursor Settings → Models，在 OpenAI API Key 一栏填入 sk-…。
- 如果你的版本有 Override OpenAI Base URL 选项，打开它并填 https://api.mallowapi.com/v1；没有这个选项就无法指向棉花糖 API。
- 添加 gpt-6.1-sol 等模型 ID。注意：自带 Key 只用于聊天，Tab 补全仍用 Cursor 自己的模型。
https://api.mallowapi.com/v1- 安装官方 SDK，把 base_url 指向棉花糖 API，其余写法和调用 OpenAI 完全一样。
pip install openai
export MALLOW_API_KEY="sk-你的密钥"import os
from openai import OpenAI
client = OpenAI(
api_key=os.environ["MALLOW_API_KEY"],
base_url="https://api.mallowapi.com/v1",
)
response = client.responses.create(
model="gpt-6.1-sol",
input="用一句话介绍你自己",
)
print(response.output_text)- 安装官方 SDK，传入 baseURL，保存为 hello.mjs 后用 node hello.mjs 运行。
npm install openai
export MALLOW_API_KEY="sk-你的密钥"import OpenAI from "openai";
const client = new OpenAI({
apiKey: process.env.MALLOW_API_KEY,
baseURL: "https://api.mallowapi.com/v1",
});
const response = await client.responses.create({
model: "gpt-6.1-sol",
input: "用一句话介绍你自己",
});
console.log(response.output_text);- 不装任何东西，先用一条命令确认密钥能用。
curl https://api.mallowapi.com/v1/responses \
-H "Authorization: Bearer $MALLOW_API_KEY" \
-H "Content-Type: application/json" \
-d '{"model": "gpt-6.1-sol", "input": "用一句话介绍你自己"}'怎么确认接通了
先列一下模型。能返回列表，说明地址和密钥都对；再发一条消息，到控制台「使用记录」能看到这次请求，就全部完成了。
curl https://api.mallowapi.com/v1/models -H "Authorization: Bearer $MALLOW_API_KEY"卡住了？先看这几个
404
地址多写了路径。Base URL 只写到 /v1，Cherry Studio 只写到域名。
403 余额不足
账户余额不够了。充值或用兑换码后会自动恢复。
429
这把密钥的额度用完了，或触发了频率限制。在控制台调高这把密钥的上限。
模型不可用
模型名要和模型列表完全一致，而且要在密钥所属的分组里。GPT 和 Grok 各用各的密钥。
还是不行
发邮件到 support@mallowapi.com，附上报错信息和响应头里的 x-request-id。