EdgeOne Makers 从入门到精通
附录

§17 用通用大模型快速搭建 AI 应用

4周前有个读者问我:"我想做个 AI 聊天 + AI 生图的小站,但怕被某个模型绑死。"我给他指了 Makers 的 AI 应用模板——原生接口和 SDK 封装两条路都给好了,模型想换就换。这一章讲清楚这两条路怎么选。

经验:搭 AI 应用最怕两件事——一是被某家模型 API 绑架,二是为接模型写一堆胶水代码。Makers 的模板把 API Key 收口到环境变量,把调用收口到两套标准模板,你换模型只改一个变量。

17.1 两条技术路径

路径 适合谁 灵活度 开发量
原生接口调用 要深度定制、自己控请求
AI SDK 封装调用 想快速集成、少写代码

模板清单:

能力 原生接口模板 AI SDK 模板
AI 对话 ai-chatbot-starter ai-sdk-chatbot-starter
AI 生图 ai-image-generator-starter ai-sdk-image-generator-starter

17.2 先拿 API Key

API Key 是访问模型的身份凭证,类似账号密码。不是所有都要申请,用到哪个申哪个。

对话模型:DeepSeek、OpenAI、Google、Anthropic/Claude、xAI

图片模型:HuggingFace、Replicate、FAL、Nebius、Fireworks、DeepInfra、Luma、Together AI

标叔的结论:新手先拿 DeepSeek 或 OpenAI 的 Key 跑通对话,生图等真要用了再申。别一上来把八家 Key 全申请一遍。

17.3 一键部署

进模板详情页,点左侧蓝色 Deploy 按钮 → 进 Makers 控制台。配置面板本质就是在填 API Key:不同模板按它支持的模型列出不同变量,你至少填一个能用的 Key。

# 以 ai-sdk-chatbot-starter 为例
git clone https://github.com/${your-github-account}/vercel-ai-sdk-chatbot.git
cd vercel-ai-sdk-chatbot

填好环境变量,点 "start deployment",完事就能开预览地址。

17.4 本地调试

部署后关联的 GitHub 账号下会多一个项目。把它拉到本地改:

git clone https://github.com/${your-github-account}/vercel-ai-sdk-chatbot.git
cd vercel-ai-sdk-chatbot
edgeone makers link   # 关联 Makers 项目,把云端环境变量同步到本地 .env
edgeone makers dev    # 本地 DEV 模式,访问 localhost:8088

建议:edgeone makers link 会在本地生成 .env 并同步云端变量,省得你手动抄。改完代码推 GitHub,Makers 自动监听、自动重新部署——你看到 "Deploying" 状态就是在跑了。

git add .
git commit -m "调整对话界面"
git push origin main

17.5 模型怎么换

因为 Key 全在环境变量里,换模型就是改 AI_GATEWAY_BASE_URL / AI_GATEWAY_API_KEY / AI_GATEWAY_MODEL 这几个值,代码一行不动。Makers 的模型网关走 OpenAI 兼容协议,DeepSeek、GPT-4o、Claude、通义千问都能接。

警告:生图模型的返回格式差异大(有的返 URL,有的返 base64)。用 AI SDK 模板能少踩这类坑,因为它把不同厂商的差异都封装了。

下一章,我们把模型再往前推一步——不调云端大模型,直接用边缘节点上的 DeepSeek,体验毫秒级响应。