边缘安全加速平台 EO 集成指南

一、创建 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 由平台加密托管，不需要写进业务代码。

内置模型和自费厂商模型可详细参考 模型与厂商概览。

四、调用 Models

以下示例使用内置模型 @makers/deepseek-v4-flash。如需调用其他模型，只需替换 model 参数。

AI SDKOpenAI JS SDKPythoncURLimport { 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");

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