接入指南：OpenAI 兼容（/v1）

用一个 Base URL + API Key 调用 Fuel；适合 OpenAI SDK、Codex 和多数支持自定义 Base URL 的客户端

MagicCore Fuel 对外提供 OpenAI 兼容接口。

接入只需要两项配置：

API Base URL：通常是 https://fuel.magiccoreai.com/v1
API Key：在控制台创建（见下一页）

必备请求头

所有请求都需要带：

Authorization: Bearer <YOUR_API_KEY>

先做一次健康检查

建议新 Key 创建后，先调：

curl https://fuel.magiccoreai.com/v1/models \
  -H "Authorization: Bearer $FUEL_API_KEY"

这一步能同时确认三件事：

Key 是否有效
这把 Key 是否绑到了正确分组
你准备使用的模型名是否真的在返回列表里

你最常用的 3 个端点

GET /v1/models：查看这把 Key 当前可用的模型
POST /v1/chat/completions：适合按 messages 组织内容的聊天客户端
POST /v1/responses：适合新式 OpenAI SDK，推荐优先使用
POST /v1/images/generations：适合图片生成，但只适用于 GPT混合池子 与 GPT纯血Pro

注意：/v1/models 的结果是按 Key 所属分组返回的。
不是所有 Key 都能看到同一批模型。

文本请求：最小可用示例（responses）

curl https://fuel.magiccoreai.com/v1/responses \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt5.5",
    "input": "用一句话解释什么是 API 网关"
  }'

这个接口里，正文最关键的是：

model
input

文本请求：如果你的客户端使用 messages

curl https://fuel.magiccoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "grok-4.20-0309-non-reasoning",
    "messages": [
      {
        "role": "user",
        "content": "Reply with exactly: OK"
      }
    ]
  }'

这个接口里，正文最关键的是：

model
messages

图片请求：最小可用示例

curl https://fuel.magiccoreai.com/v1/images/generations \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2",
    "prompt": "a clean product poster with white background"
  }'

如果这把 Key 绑定的是 Claude按次计费、Gemini/Grok按次计费 或 ClaudeMax满血版，不要调用这条接口。
图片模型 gpt-image-* 只在 GPT混合池子 与 GPT纯血Pro 开放。

JavaScript / TypeScript（OpenAI SDK）

import OpenAI from "openai";

const client = new OpenAI({
  apiKey: process.env.FUEL_API_KEY,
  baseURL: "https://fuel.magiccoreai.com/v1",
});

const response = await client.responses.create({
  model: "gpt5.5",
  input: "用一句话介绍 MagicCore Fuel",
});

console.log(response.output_text);

Python（OpenAI SDK）

from openai import OpenAI

client = OpenAI(
    api_key="YOUR_FUEL_API_KEY",
    base_url="https://fuel.magiccoreai.com/v1",
)

resp = client.responses.create(
    model="gpt5.5",
    input="用一句话介绍 MagicCore Fuel",
)

print(resp.output_text)

什么时候不要用这一页

如果你使用的是 Claude Code / Anthropic SDK，并且你想直接走 POST /v1/messages，请改看：

常见问题

401 Unauthorized：通常是没带 Key、Key 无效，或 Key 已被禁用
400 model not supported：通常是你这把 Key 的分组不支持该模型
429 Too Many Requests：触发了并发或速率限制；部分场景也可能因余额不足被保护性拒绝
图片接口报 400 model not supported 时，先检查这把 Key 是否属于 GPT混合池子 或 GPT纯血Pro
如果你不确定该写 input 还是 messages：看请求格式与示例

接入指南：OpenAI 兼容（/v1）

On this page