接入指南：OpenAI 兼容 (/v1)

MagicCore Fuel 全面兼容官方 OpenAI REST API 规范。市面上绝大多数支持自定义 OpenAI 域名与 API Key 的工具、脚本与 SDK，均可无缝切换接入。

---

统一端点与鉴权

• Base URL: https://fuel.magiccoreai.com/v1
• 鉴权 Header: Authorization: Bearer sk-...

---

常用接口速查

1. 模型列表 (GET /v1/models)

查询当前 Key 所在分组支持调用的所有模型：

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

2. 聊天补全 (POST /v1/chat/completions)

标准对话接口，支持单轮与多轮上下文：

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": "system", "content": "You are a helpful assistant."},
      {"role": "user", "content": "Hello!"}
    ],
    "stream": false
  }'

3. 流式传输 (stream: true)

开启流式输出时，Fuel 支持 Server-Sent Events (SSE) 逐字返回，适合实时 Web 对话界面：

curl -N https://fuel.magiccoreai.com/v1/chat/completions \
  -H "Authorization: Bearer $FUEL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "gpt-5.6-terra",
    "messages": [{"role": "user", "content": "讲个笑话"}],
    "stream": true
  }'

注意：针对超长推理模型（如 deepseek-v4-pro），思考过程可能长达数十秒甚至上百秒。请确保客户端或反代层（如 Nginx、CDN）设置了足够的超时时间（建议 read_timeout ≥ 300s）。