Makers Models 集成
Makers Models 是部署在 EdgeOne 边缘节点的统一模型接入服务，通过一个网关地址和 API Key，您可以调用多家模型厂商，并通过修改
model 参数切换模型，无需在业务代码中分别适配各厂商的鉴权方式。本文介绍如何完成 API Key 创建、模型选择、代码接入、本地调试与部署。快速开始
1、选择项目类型
项目类型 | Key 与配置来源 |
Agent 项目 | 部署时自动配置模型网关变量 |
Web 项目 | 在 Models 控制台手动创建 API Key |
如果想搭建一个 Agent 项目，推荐从 OpenAI Agents Starter 开始：点击
Deploy、关联 Git 平台并创建项目，平台完成构建和部署，无需手动创建 Models API Key。2、选择模型来源
Makers Models 提供两种模型来源，但应用始终使用 Models API Key 鉴权；绑定的第三方厂商 Key 由平台加密托管，不需要写进业务代码。
维度 | 内置模型 | 自费厂商模型（BYOK） |
前置准备 | 无需绑定厂商 Key | 在控制台绑定对应厂商 API Key |
模型 ID | @makers/<model> | <provider>/<model> |
计费 | 使用 Makers 提供的限量额度 | 费用计入开发者的厂商账户 |
适用场景 | Demo、教学、原型和技术验证 | 生产环境、指定商用模型 |
3、配置环境变量
进入 Makers 控制台 →
Models → API Key 创建 Key，创建并妥善保存 Makers Models API Key：MAKERS_MODELS_KEY=your-api-key-here
应用访问模型时使用的是 Makers Models API Key。如果后续接入自费厂商模型，厂商 API Key 只需绑定到控制台，由平台加密托管，不应写入业务代码。
安全提示：API Key 只能保存在服务端环境变量中。请勿将其写入前端代码、日志或提交到 Git 仓库。
调用 Models
以下示例使用内置模型
@makers/deepseek-v4-flash。如需调用其他模型，只需替换 model 参数。import { createAiGateway } from "@edgeone/makers-models-provider";import { generateText } from "ai";const aiGateway = createAiGateway({apiKey: process.env.MAKERS_MODELS_KEY,});const { text } = await generateText({model: aiGateway("@makers/deepseek-v4-flash"),prompt: "What can you do?",});
import OpenAI from "openai";const client = new OpenAI({apiKey: process.env.MAKERS_MODELS_KEY,baseURL: "https://ai-gateway.edgeone.link/v1",});const completion = await client.chat.completions.create({model: "@makers/deepseek-v4-flash",messages: [{ role: "user", content: "What can you do?" }],});
import osfrom openai import OpenAIclient = OpenAI(api_key=os.getenv("MAKERS_MODELS_KEY"),base_url="https://ai-gateway.edgeone.link/v1",)completion = client.chat.completions.create(model="@makers/deepseek-v4-flash",messages=[{"role": "user", "content": "What can you do?"}],)
curl -X POST "https://ai-gateway.edgeone.link/v1/chat/completions" \--header "Authorization: Bearer $MAKERS_MODELS_KEY" \--header "Content-Type: application/json" \--data '{"model": "@makers/deepseek-v4-flash","stream": true,"messages": [{"role": "user", "content": "What can you do?"}]}'
切换模型
切换内置模型
内置模型 ID 以
@makers/ 开头。切换时只需修改模型 ID：const model = aiGateway("@makers/kimi-k2.6");
切换为自费厂商模型
1. 进入 Makers 控制台的
Models 页面；2. 选择模型厂商并绑定该厂商的 API Key；
3. 将
model 改为 <provider>/<model>，例如 anthropic/claude-sonnet-5；4. 保持 Makers Models 网关 Key 和 Base URL 不变；
5. 更新环境变量或代码后重新部署。
注意：厂商 API Key 用于 Makers 网关向厂商发起请求；应用自身仍使用 Makers Models 网关 Key。厂商的模型可用范围、区域限制、额度和计费规则，以对应厂商账户为准。
本地调试与部署
1. 启动本地开发服务
edgeone makers dev
默认访问地址为
http://localhost:8088/。如果是 Agent 项目，还可以通过 http://localhost:8088/agent-metrics 访问 本地可观测链路追踪页面。2. 部署项目
如果项目已关联 Git 仓库，推送代码即可触发 Makers 的 CI 构建与部署。也可以通过 CLI 直接部署：
# 部署至生产环境edgeone makers deploy
