请求格式与示例

如果你已经拿到了 Fuel 的 Key，这页可以直接告诉你：

请求地址该填什么
请求头该怎么带
responses 怎么写
chat/completions 怎么写
Anthropic /v1/messages 怎么写
图片请求怎么写

先记住这 3 个固定项

不管你用哪种协议，先把这 3 件事记住：

先确认你的 Key 绑定的是哪个分组
先用 GET /v1/models 看这把 Key 当前能看到哪些模型
请求里始终使用 Fuel 返回的模型名，不要自己猜

OpenAI 兼容主线：

Base URL：https://fuel.magiccoreai.com/v1
请求头：Authorization: Bearer <YOUR_FUEL_KEY>

Anthropic messages 主线：

Base URL：https://fuel.magiccoreai.com
请求头：x-api-key: <YOUR_FUEL_KEY>

最常见的 4 种请求格式

1. `POST /v1/responses`

适合：

大多数文本调用
OpenAI SDK 新接口
你想用最简单的文本输入方式

最小示例：

curl https://fuel.magiccoreai.com/v1/responses \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt5.5",
    "input": "用一句话介绍 MagicCore Fuel"
  }'

你只需要记住：

这个接口用的是 input
不是 messages

2. `POST /v1/chat/completions`

适合：

旧式 OpenAI Chat Completions 客户端
你的工具本身就是按 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"
      }
    ]
  }'

你只需要记住：

这个接口用的是 messages
messages 必须是数组
每条消息至少有 role 和 content

3. `POST /v1/messages`

适合：

Claude Code
Anthropic SDK
你本来就在用 Anthropic 的 messages 协议

最小示例：

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

你只需要记住：

这里不是 Authorization: Bearer
这里默认用 x-api-key
anthropic-version 也要带上

4. `POST /v1/images/generations`

适合：

图片生成
模型名通常是 gpt-image-*

最小示例：

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"
  }'