客户端配置（Codex / Claude / Gemini）

这页只解决一个问题：不同客户端到底该拿哪把 Key、填哪个 Base URL、发哪种格式的请求。

第一步：先选对 Key

不是所有客户端都应该用同一把 Key。

如果你拿错了 Key，最常见的结果是：

• GET /v1/models 看不到目标模型
• /v1/messages 被拒绝
• 或者模型名明明存在，但当前分组不支持

OpenAI 兼容客户端

适用：

• Codex
• OpenAI SDK
• 大多数支持自定义 OpenAI Base URL 的工具
• 绑定 GPT混合池子、GPT纯血Pro、Claude按次计费、Gemini/Grok按次计费 的 Key
• 也适用于想用 OpenAI SDK 调 Claude 模型的人

通用参数：

• BASE_URL=https://fuel.magiccoreai.com/v1
• API_KEY=<你的 Fuel Key>

示例：环境变量

export OPENAI_BASE_URL="https://fuel.magiccoreai.com/v1"
export OPENAI_API_KEY="<YOUR_FUEL_KEY>"

调用时请使用 Fuel 返回的统一模型名，例如：

• gpt5.5
• gpt5.4
• claude-opus-4.7
• gemini-3.1-pro-preview

如果你的客户端会自己拼请求体：

• 文本优先看 responses
• 聊天类工具看 chat/completions
• 图片模型只看 images/generations，而且只适用于 GPT混合池子 / GPT纯血Pro

Claude按次计费 / Gemini/Grok按次计费 / ClaudeMax满血版 虽然也能走 OpenAI 兼容 /v1，但它们不支持 gpt-image-* 或 POST /v1/images/generations。

另外：ClaudeMax满血版 仅允许 Claude Code 客户端。普通 OpenAI / Anthropic SDK 调它会被拒绝；想用 OpenAI SDK 跑 Claude，请改用 Claude按次计费。

可直接参考：

• 请求格式与示例

Claude Code / Anthropic 客户端

适用：

• Claude Code
• 自己直接调用 Anthropic /v1/messages
• 绑定 ClaudeMax满血版 的 Key

推荐参数：

export ANTHROPIC_BASE_URL="https://fuel.magiccoreai.com"
export ANTHROPIC_API_KEY="<YOUR_CLAUDEMAX_KEY>"
export ANTHROPIC_MODEL="claude-opus-4.7"

最小校验

先确认这把 Key 能看到 ClaudeMax 的模型：

curl https://fuel.magiccoreai.com/v1/models \
  -H "x-api-key: $ANTHROPIC_API_KEY"

再测试 messages：

curl https://fuel.magiccoreai.com/v1/messages \
  -H "x-api-key: $ANTHROPIC_API_KEY" \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "claude-opus-4.7",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Reply with exactly: OK"}]
  }'

如果你的客户端本地还有代理层、包装脚本或路由器，请确认它没有把请求重新改回别的 Base URL。
最稳的做法，是先用上面的最小请求把链路打通。

如果你虽然主要用 Claude 模型，但客户端本身是 OpenAI SDK，也没问题。
这时直接改看：

• OpenAI 兼容接入
• 请求格式与示例

客户端配置的通用原则

• 新 Key 到手后，先调 GET /v1/models
• 始终按返回的统一模型名调用
• GPT 和 Claude 建议分开建 Key
• 需要图片模型时，只使用 GPT混合池子 或 GPT纯血Pro 的 Key
• 出现“模型不支持”时，先检查分组，不要先怀疑 SDK
• 出现“到底该写 input、messages 还是 prompt”时，先看 请求格式与示例