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

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

你只需要两样东西：

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

必备请求头

所有请求都需要带：

Authorization: Bearer <YOUR_API_KEY>

你会用到的三个常见端点

• GET /v1/models：查看可用模型列表
• POST /v1/chat/completions：Chat Completions 兼容接口
• POST /v1/responses：Responses 兼容接口（更推荐的新口径）

注意：具体支持哪些能力（如工具调用、多模态、长上下文等）取决于你选的模型与通道。

最小可用示例（curl）

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

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

常见问题

• 401 Unauthorized：大概率是没带 key / key 无效 / key 被禁用。
• 429 Too Many Requests：触发了并发或速率限制，或账户余额不足导致的保护性拒绝（具体以错误提示为准）。