磐石API · 接入教程 模型广场 进入控制台

5 分钟接入磐石API

一个 Key，调用 Claude、GPT 等主流模型。跟着做就行，不需要懂技术。

注册填个邮箱
充值先充 10 元
建 Key复制那串码
填进软件或跑脚本

👇 你用的是哪个软件？点一下

选好之后，下面只显示这一个软件的做法，不用翻完整页。

❓ 能在 Claude 官方客户端里用吗？ 不能。Claude 桌面版和 claude.ai 网页版走的是 Anthropic 账号登录，不读 API Key， 官方没有提供修改接入地址的入口——所有中转站都一样，不是磐石的限制。
想用命令行 → 选上面的 Claude Code，有一键脚本
想用图形界面 → 选上面的 Cherry Studio，和官方客户端体验接近，还能同时切换多个模型

第一步 · 拿到你的 Key

不管用哪个软件，都要先有一串 Key。它等于「账号密码合二为一的通行码」。

① 注册并充值

  1. 在 注册页 填邮箱和密码，注册后登录。
  2. 进入控制台，左边菜单点「充值/订单」。
  3. 1 元人民币 = 1 美元额度，第一次建议先充 10 元试水。微信或支付宝扫码即可。

② 创建 Key（这一步最容易出错）

① ② ① 充值/订单 ② API 密钥 ← 在这里建 Key 创建密钥 名称 我的电脑（随便写） 分组 ← 这一步最容易错 想用 Claude 选 Claude 组，想用 GPT 选 GPT 组 确定
控制台界面示意：左边菜单找「API 密钥」→ 右上角「创建密钥」→ 注意选对分组
🔑 一句话记住分组规则 想用 Claude 模型 → 建 Key 时选 Claude 分组；想用 GPT → 选 GPT 分组。对不上会报错。
你想用的模型建 Key 时选的分组
Claude Opus / SonnetClaude MAX / 平稳组 / Kiro
GPT-5.5 / 5.6 / 6GPT-pro 号池 / 稳定 / 高速
KiMi国产模型 KiMi
🚨 Key 只显示一次 那串 sk- 开头的密钥只在创建时完整显示一次，关掉窗口就看不全了。 立刻复制存到备忘录。丢了也没关系，删掉重建一个即可——但别发给任何陌生人，它等于你的钱包。

第二步 · 填进你的软件

👆 在上面选一下你用的软件，这里会显示对应的做法。

第二步 · 配置 Claude Code

用 Claude 分组 的 Key。两种方式，推荐第一种。

方式 A：一键脚本（推荐，不用自己改文件）

💡 脚本会做什么 自动备份你原有配置 → 只加磐石这一段（原设置一律保留）→ 自动填好接入地址 → 发一次真实请求验证，失败会直接告诉你是 Key 错了、余额不够还是模型选错了。 用 CC Switch 的同学也适用，脚本改的就是它管理的那两个文件。
下载并运行选你的系统 macOS / Linux Windows
终端里粘贴这一行，回车
curl -fsSL https://panshiapi.com/install/claude-code-mac.sh | bash

运行后按提示粘贴 Key 即可。想先看源码再运行，把链接贴浏览器里打开就能看全文。

  1. 点上面的「Windows」按钮，下载 .ps1 文件。
  2. 在下载到的文件上右键 → 选「使用 PowerShell 运行」。
  3. 按提示粘贴你的 Key，回车。

方式 B：手动设两个环境变量

终端执行（把 sk-xxx 换成你的 Key）
export ANTHROPIC_BASE_URL=https://api.panshiapi.com
export ANTHROPIC_AUTH_TOKEN=sk-xxx
claude

想每次自动生效，把前两行加到 ~/.zshrc 或 ~/.bashrc。

PowerShell 执行
$env:ANTHROPIC_BASE_URL="https://api.panshiapi.com"
$env:ANTHROPIC_AUTH_TOKEN="sk-xxx"
claude
✅ 成功是什么样子 启动后随便问一句，能正常回答就是通了。想指定模型加 --model claude-opus-4-8。
⚠️ 注意地址不带 /v1 Claude Code 的地址是 https://api.panshiapi.com，末尾不要加 /v1（加了本站也能认，但建议照抄）。

第二步 · 配置 Codex CLI

用 GPT 分组 的 Key。

方式 A：一键脚本（推荐）

下载并运行选你的系统 macOS / Linux Windows
Mac / Linux：终端粘贴这一行
curl -fsSL https://panshiapi.com/install/codex-mac.sh | bash

Windows：下载 .ps1 后右键「使用 PowerShell 运行」。

⚠️ 原来用 ChatGPT 账号登录过 Codex 的注意 脚本不会动你原有配置，而是新建一个独立档位。之后用 codex --profile panshi 调用磐石，用原来的方式仍然走 ChatGPT 账号。

方式 B：手动设环境变量

终端执行
export OPENAI_BASE_URL=https://api.panshiapi.com/v1
export OPENAI_API_KEY=sk-xxx
codex

或在 ~/.codex/config.toml 里把 base_url 设为 https://api.panshiapi.com/v1。模型名从模型广场复制，如 gpt-5.6-sol。

⚠️ 这个地址要带 /v1 和 Claude Code 相反，Codex 的地址末尾要加 /v1。

第二步 · 配置 Cherry Studio

图形界面软件，只需要填两个输入框，没有命令行。

设置 → 模型服务 OpenAI API 地址 / Base URL https://api.panshiapi.com/v1 API 密钥 sk-你复制的那一串
Cherry Studio 界面示意：就填这两个黄框
  1. 打开 Cherry Studio →「设置」→「模型服务」。
  2. 找到 OpenAI（或点「添加」建一个自定义服务），按上图填两个框。
  3. 在「模型」里手动添加模型，名称从模型广场复制，如 gpt-5.5。
  4. 回到聊天界面，选中刚加的模型，发一句「你好」测试。
✅ 想用 Claude 模型也走这一栏 地址一样填 https://api.panshiapi.com/v1，Key 换成 Claude 分组的， 模型名填 claude-sonnet-4-6 之类。本站会自动兼容。

第二步 · 配置 Cursor

图形界面，填两个框 + 加模型名。

  1. Cursor →「Settings」→「Models」。
  2. 展开「OpenAI API Key」，把 Override OpenAI Base URL 填成 https://api.panshiapi.com/v1。
  3. API Key 填你的 sk- Key，点「Verify」验证。
  4. 在模型列表里手动添加要用的模型名（从模型广场复制）。
⚠️ 某个模型用不了就换一个 Cursor 的部分高级功能（如 Agent）对模型有特定要求。若某模型不可用， 换 gpt-5.5 或 claude-sonnet-4-6 试试。

需要时再看

下面的内容默认收起来，点标题展开。

⚡ 避雷指南 6 个坑，90% 新手都会踩
雷区 1：模型名手打错一个字母 最常见的错误。claude-opus-5 手打容易漏字母。 ✅ 永远从模型广场复制模型名，不要凭记忆打。
雷区 2：Key 的分组和模型对不上 拿 GPT 分组的 Key 去调 Claude 模型，一定报错。 ✅ 想两种都用，就建两个 Key。
雷区 3：复制 Key 时多带了空格或引号 从聊天软件复制常会带上前后空格、换行或引号，填进去就成了「无效 Key」。 ✅ 只复制 sk- 开头到结尾那一串，前后不留空格。
雷区 4：地址填错了带不带 /v1 Claude Code 要不带 /v1；Cursor、Cherry、Codex 要带 /v1。 ✅ 本站两种都兼容，但连不上时先照速查表加上或去掉再试。
雷区 5：把 Key 发给别人 / 截图发群 Key 等于你的钱包，别人拿到就能花你的余额。 ✅ 截图求助前先打码。怀疑泄露立刻删掉旧的、建新的。
雷区 6：以为「充了钱就一直有」 余额按实际用量扣，用多少扣多少。 ✅ 在「仪表盘」随时看余额，设置里可开「余额不足提醒」。
🛠️ 报错了怎么办 按报错里的数字对号入座
报错里出现什么意思 · 怎么办
401 / unauthorized / Key 无效 Key 不对。① 回「API 密钥」重新复制，别带空格；② 别把 Bearer 也复制进去，只要 sk- 那串；③ Key 被删过就建个新的。
404 / model_not_found 找不到模型。① 模型名多半打错，从模型广场重新复制；② 检查 Key 分组和模型是否对应。
403 / 分组已停用 该分组临时下线维护。换个分组的模型，或看站内公告、问客服何时恢复。
402 / insufficient / 余额不足 钱不够了。去左侧「充值/订单」充值，1 元 = 1 美元额度。
429 / rate limit 一下发太多请求，或上游正忙。等几秒重试。持续出现请联系客服并说明模型名和时间。
Claude Code 一直转圈不出字 ① 地址必须是 https://api.panshiapi.com（不带 /v1）；② 变量名要用 ANTHROPIC_AUTH_TOKEN，不是 ANTHROPIC_API_KEY；③ Key 要用 Claude 分组的。
偶尔失败，重试又好了 个别上游高峰期有波动，属正常。持续发生请联系客服，我们会切换线路。
回复夹着英文「思考过程」 个别国产模型会把思考内容一起输出。换 Claude 或 GPT 分组的模型即可。
📋 接入地址速查表 各软件该填哪个地址
软件 / 场景接入地址用哪种 Key
Claude Codehttps://api.panshiapi.comClaude 分组
Codex / Codex CLIhttps://api.panshiapi.com/v1GPT 分组
Cursorhttps://api.panshiapi.com/v1对应模型的分组
Cherry Studio 等聊天软件https://api.panshiapi.com/v1对应模型的分组
OpenAI SDK（Python/Node）https://api.panshiapi.com/v1对应模型的分组
Anthropic SDKhttps://api.panshiapi.comClaude 分组

地址末尾带不带 /v1 本站都能识别，填错不会报 404。

🐍 用代码调用 Python / Node.js / curl
pip install openai
from openai import OpenAI
client = OpenAI(
    base_url="https://api.panshiapi.com/v1",
    api_key="sk-xxx",
)
r = client.chat.completions.create(
    model="gpt-5.5",
    messages=[{"role": "user", "content": "你好"}],
)
print(r.choices[0].message.content)
npm i openai
import OpenAI from "openai";
const client = new OpenAI({
  baseURL: "https://api.panshiapi.com/v1",
  apiKey: "sk-xxx",
});
const r = await client.chat.completions.create({
  model: "gpt-5.5",
  messages: [{ role: "user", content: "你好" }],
});
console.log(r.choices[0].message.content);
终端执行
curl https://api.panshiapi.com/v1/chat/completions \
  -H "Authorization: Bearer sk-xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "messages": [{"role":"user","content":"你好"}]
  }'
📊 用量与账单 钱花哪了 · 怎么省

控制台左侧「使用记录」可查看每一次请求的时间、模型、token 消耗和花费。 「仪表盘」有今日/累计用量汇总。对某笔扣费有疑问，把时间和模型发给客服即可核对。

💡 省钱小技巧 反复使用同一段上下文时，模型的 prompt caching（缓存） 会自动生效， 缓存部分的价格远低于新输入，能明显降低成本。所以在同一个会话里连续对话，比每次新开会话便宜得多。
💬 联系客服 QQ / 微信

QQ：2678401012　　微信：jnzgz888

联系时请附上：用的软件、模型名、报错截图、大致时间，方便我们快速定位。 截图前记得把 Key 打码。