请求协议与格式规范

无论使用哪种语言或客户端，拿到 Fuel Key 后的底层 HTTP 请求规范如下。

---

4 种核心请求协议与示例

1. OpenAI 对话补全 (POST /v1/chat/completions)

• 适用场景：绝大多数支持 OpenAI 协议的第三方客户端与脚本。
• 请求头：Authorization: Bearer <API_KEY>
• 请求体关键字段：model、messages (数组格式，包含 role 和 content)。

curl https://fuel.magiccoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "deepseek-v4-pro",
    "messages": [
      {"role": "user", "content": "你好，请给出一段快速排序算法"}
    ]
  }'

---

2. OpenAI 单次输入响应 (POST /v1/responses)

• 适用场景：新版轻量 SDK 或需要极简单次文本生成的任务。
• 请求头：Authorization: Bearer <API_KEY>
• 请求体关键字段：model、input（字符串或单一对象）。

curl https://fuel.magiccoreai.com/v1/responses \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.5",
    "input": "用一句话解释相对论"
  }'

---

3. Anthropic 原生消息接口 (POST /v1/messages)

• 适用场景：Claude Code 官方终端、Anthropic 原生 SDK、支持原生 Claude 协议的开发工具。
• 请求头：
  • x-api-key: <API_KEY>
  • anthropic-version: 2023-06-01
• 请求体关键字段：model、max_tokens（必填）、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-sonnet-5",
    "max_tokens": 1024,
    "messages": [
      {"role": "user", "content": "请提供一份系统架构审查清单"}
    ]
  }'

注意：如果该请求针对的是 ClaudeMax 分组，请确保请求是通过 Claude Code 官方终端发起（会附带特定的 UA 特征），否则会被网关安全拦截。普通客户端请使用 Kiro按量计费 分组 Key。

---

4. 图像生成接口 (POST /v1/images/generations)

• 适用场景：AI 绘画、设计出图、海报生成。
• 权限要求：仅限绑定 GPT稳定池 或 GPT纯血Pro订阅 的 Key。
• 请求头：Authorization: Bearer <API_KEY>
• 请求体关键字段：model（如 gpt-image-2、gpt-image-2.5）、prompt、size（可选，如 1024x1024）。

curl https://fuel.magiccoreai.com/v1/images/generations \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-image-2.5",
    "prompt": "极简北欧风格客厅，柔和阳光穿透白纱窗帘，8k高清摄影风格",
    "size": "1024x1024"
  }'