快速开始

Fusion 同时支持兼容 OpenAI 的 Chat Completions 和 Responses API。本页使用 Chat Completions 完成首次调用；使用 Responses 的客户端请参阅 Responses API。

开始前需要准备三个值：

获取 API Key

本页适用于在 FUMO 网页注册的线上自助客户。通过销售开通企业账号的客户，请使用企业接入指南。

1. 创建账号。 打开注册页，使用邮箱和验证码注册，或选择 Google / GitHub 登录。邮箱注册时，如已有销售人员与你对接，请填写对方提供的 Sales Code。已有账号可直接登录。
2. 准备可用额度。 在账号页绑定支付卡，查看可领取的启动额度，并按需充值。
3. 创建 API Key。 在控制台打开 API Keys（API 密钥），点击 Create New Key（创建新密钥），填写密钥名称并创建。
4. 复制 Key。 创建后返回密钥列表，点击 Copy（复制），按下文保存到环境变量中。

通过 Google / GitHub 登录，或注册时未填写 Sales Code 的用户，可在账号页绑定销售提供的代码。

在账号页查看余额与 Fusion 剩余额度，在模型页查看模型 ID 和价格。控制台各入口的说明见控制台与账号。

保存 API Key

不要把凭证写入源代码、浏览器端代码、日志或公开仓库。

export FUMO_API_KEY="your-key"

生产环境应使用部署平台的密钥管理功能，或专门的密钥管理服务。

示例使用 FUMO_API_KEY 作为本地环境变量名。你可以使用其他名称，并同步修改客户端配置。

选择模型 ID

以下模型使用相同的 API Key 和 Base URL。在请求的 model 字段中填写已为当前 Key 授权的模型 ID。

Fusion 模型

发送第一个请求

完整的公开接口为：

POST https://capi.fumolab.ai/api/fusion/v1/chat/completions

curl https://capi.fumolab.ai/api/fusion/v1/chat/completions \
  -H "Authorization: Bearer $FUMO_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "fusion-max-1.0",
    "messages": [
      {"role": "user", "content": "Explain the trade-offs in this design."}
    ]
  }'

调用成功，即可确认 API Key、模型授权、请求格式和网络链路均正常。

使用 OpenAI Python SDK

安装 SDK：

pip install openai

将客户端指向 Fusion Base URL：

import os
from openai import OpenAI

client = OpenAI(
    base_url="https://capi.fumolab.ai/api/fusion/v1",
    api_key=os.environ["FUMO_API_KEY"],
)

response = client.chat.completions.create(
    model="fusion-max-1.0",
    messages=[
        {"role": "system", "content": "Be precise and state your assumptions."},
        {"role": "user", "content": "Review this migration plan."},
    ],
)

print(response.choices[0].message.content)

使用 OpenAI TypeScript SDK 流式调用

安装 SDK：

pnpm add openai

创建流式请求：

import OpenAI from "openai";

const client = new OpenAI({
  baseURL: "https://capi.fumolab.ai/api/fusion/v1",
  apiKey: process.env.FUMO_API_KEY,
});

const stream = await client.chat.completions.create({
  model: "fusion-code-1.0",
  messages: [
    { role: "user", content: "Find the race condition and propose a patch." },
  ],
  stream: true,
});

for await (const chunk of stream) {
  process.stdout.write(chunk.choices[0]?.delta?.content ?? "");
}

首次调用排障

401 — 鉴权失败

确认请求包含 Authorization: Bearer <API_KEY>，并检查 Key 是否被截断，或被其他环境变量覆盖。

403 — 无服务权限

API Key 有效，但无权使用所请求的模型或 Fusion 服务。先核对请求中的模型 ID；仍无法调用时，请联系支持团队并提供模型 ID、错误信息和 request_id。通过销售开通的账号，也可以请对接销售确认服务配置。

404 — 路由不存在

确认 Base URL 以 /v1 结尾，客户端请求 /chat/completions 或 /responses，且模型 ID 是已授权别名。具体错误 envelope 可能因网关而异。

通过 Responses 配置 Codex · 通过 Chat Completions 配置 OpenCode · 查看 Responses API 契约

三款均为 AVAILABLE，最大输出 128K；Max 2.0 / Max 1.0 上下文为 1M，Code 1.0 为 512K。支持文本/图片输入和文本/工具调用输出；文件由 Agent 读取，不支持原生文件上传。

企业客户

使用销售开通的企业账号？请前往企业接入指南，获取对应的 API Key 和 Base URL。绑定 Sales Code 不会改变线上自助账号的接入地址。