Makers Models 集成
Makers Models 是部署在 EdgeOne 边缘节点的统一模型接入服务，通过一个网关地址和 API Key，您可以调用多家模型厂商，并通过修改
model 参数切换模型，无需在业务代码中分别适配各厂商的鉴权方式。本文介绍如何完成 API Key 创建、模型选择、代码接入、本地调试与部署。快速开始
创建 Models API Key
1. 访问 Makers 控制台。
2. 登录您的账户并开通 Makers。
3. 在 Makers / Models / API Key 页面创建 API Key。
4. 复制您的 API Key 以供使用。
Agent 项目无需主动配置 Key
如果您正在开发 Agent 项目，只需在项目根目录的
edgeone.json 中通过 agents.framework 指定所使用的 Agent 框架。部署完成后，Makers 将自动配置模型网关所需的环境变量，无需您手动创建或配置 API Key。{"agents": {"framework": "openai-agents-sdk" // 还支持 claude-agent-sdk、langgraph、crewai 和 deepagents。}}
选择模型来源
Makers Models 提供两种模型来源，但应用始终使用 Models API Key 鉴权；绑定的第三方厂商 Key 由平台加密托管，不需要写进业务代码。
维度 | 内置模型 | 自费厂商模型（BYOK） |
前置准备 | 无需绑定厂商 Key | 在控制台绑定对应厂商 API Key |
模型 ID | @makers/<model> | <provider>/<model> |
计费 | 使用 Makers 提供的限量额度 | 费用计入开发者的厂商账户 |
适用场景 | Demo、教学、原型和技术验证 | 生产环境、指定商用模型 |
调用 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 -n <项目名>
部署成功后点击 Console 的链接可以访问具体构建信息和部署后的 URL。
