帮你快速理解、总结文档立即下载
文档中心>边缘安全加速平台 EO>Makers>集成指南>AI>Makers Model 集成

Makers Model 集成

最近更新时间：2026-09-15 11:42:32
本文档已由 AI 辅助审校
我的收藏

本页目录：

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。
  }
}
如果想快速搭建 Agent 项目，可以从 OpenAI Agents Starter 开始：点击 Deploy，关联 Git 平台并创建项目，平台将自动完成构建和部署。

选择模型来源

Makers Models 提供两种模型来源，但应用始终使用 Models API Key 鉴权；绑定的第三方厂商 Key 由平台加密托管，不需要写进业务代码。
维度
内置模型
自费厂商模型（BYOK）
前置准备
无需绑定厂商 Key
在控制台绑定对应厂商 API Key
模型 ID
@makers/<model>
<provider>/<model>
计费
使用 Makers 提供的限量额度
费用计入开发者的厂商账户
适用场景
Demo、教学、原型和技术验证
生产环境、指定商用模型
内置模型和自费厂商模型可详细参考 模型与厂商概览。

调用 Models

以下示例使用内置模型 @makers/deepseek-v4-flash。如需调用其他模型，只需替换 model 参数。
AI SDK
OpenAI JS SDK
Python
cURL
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 os
from openai import OpenAI

client = 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");
模型清单可能更新，建议从控制台或 模型与厂商概览 复制当前可用的完整模型 ID。

切换为自费厂商模型

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 CLI 后，即可在本地启动并调试项目。若需使用 Makers 控制台中已配置的环境变量，请先执行 edgeone makers link 关联已有项目。
edgeone makers dev
默认访问地址为 http://localhost:8088/。如果是 Agent 项目，还可以通过 http://localhost:8088/agent-metrics 访问 本地可观测链路追踪页面。

2. 部署项目

如果项目已关联 Git 仓库，推送代码即可触发 Makers 的 CI 构建与部署。也可以通过 CLI 直接部署：
# 部署至生产环境
edgeone makers deploy -n <项目名>
部署成功后点击 Console 的链接可以访问具体构建信息和部署后的 URL。
中国站