火山引擎 IGA Pages 集成 AI 加速网关：不用自己配 Key、搭代理

想给 Web 应用接上大模型，一般得先备好一条服务端调用链路。

模型 API Key 一旦写进前端代码，就会跟着客户端资源一起暴露出去。所以开发者得从服务端发起请求，这就要申请并保管 API Key、配好模型服务地址、写转发逻辑，还要解决前端和代理之间的跨域问题。

代理这层东西还得单独部署、单独维护。页面和业务逻辑之外，模型服务、服务端运行环境、托管平台，开发者要分别去管。

IGA Pages 属于火山引擎全站加速产品体系，提供 Web 应用托管和部署能力。现在它把 AI 加速网关集成进来，模型接入、服务端调用、应用部署被串成了一条线。

建 Pages 项目时打开 AI 加速网关，系统就会给你的账号自动创建一个专属网关实例。模型服务地址和 API Key 填进项目配置，应用代码直接读取即可调用模型。自己申请 Key、搭代理、处理跨域这些事都省了。

为了让开发者直接上手体验，IGA Pages 联合 AI 加速网关给每个账号 50 万 Token 免费额度，Pages 专属网关实例的网关流量费和请求数费也一并免掉。

模型、Key、部署，一次配齐

集成 AI 加速网关之后，开发者可以在 Pages 项目里配置模型、发起服务端调用，再把应用部署出去：

• 模型调用交给网关代理。AI 加速网关兼容 OpenAI 协议，在应用和模型服务商之间充当统一的代理层。应用把模型请求发给网关，网关再转发到后端的模型服务。开发者不用直接对接模型供应商的 API，也不用在应用里处理各家供应商的接入差异。

• 请求在服务端执行，Key 不会暴露。应用通过 Pages Functions 在服务端发起模型请求，API Key 留在服务端环境变量里，进不了前端代码。

• 部署即分发。应用部署到 IGA Pages 后，经全站加速网络分发，拿到一个可访问的线上地址。

• 换模型不用改代码。想试别的模型，在网关控制台切换即可。应用始终走同一个网关入口调用，接入代码不用动。

*免费额度覆盖平台免费模型；需要特定模型时，在网关实例中配置自有模型，费用由对应供应商结算。

先看效果

我们还做了一个 Demo 模板“AI 推理任务 · 静默航线”，用来展示 IGA Pages 加 AI 加速网关能做出什么样的应用。

这套玩法本身就是一个完整的互动推理故事：AI 当故事主持人，开场叙述、行动反馈、人物对话和结局复盘都由它负责，玩家则扮演执行者。分支不止一条，还有资源约束和多种结局；判定规则交给确定性引擎执行，AI 只管叙事表达。

这个模板已经把模型接好了，可以直接运行和部署。

动手体验

动手之前，先确认下面这些环境已经就绪：

• TRAE 已安装

• Node.js 22.15.0 或更高版本

• 火山引擎账号已完成实名认证，已开通智能全球加速

• IGA CLI 已安装

从模板搭建，体验完整 AI 应用

打开 TRAE，进入 插件市场 > 技能 > 开发工具，找到 IGA 一键部署，点击 使用。

对 TRAE 说：

在TRAE中调用IGA一键部署技能，选“AI推理任务 · 静默航线”模板建一个叫my-mystery-story的项目。本地和远端的模型配置要同步，IGA Pages上的云端项目创建与关联、AI加速网关的接入，也一并交给它完成。

TRAE接下IGA一键部署技能后，动作是连着来的：先把模板里的整套项目代码取到本地，再去IGA Pages上建好远端项目并建立关联。

1. 接着，账号下若已有Pages专属AI加速网关实例就直接复用，没有就新建一个。

1. 模型服务地址和API Key这两项，会被分别写进本地与远端的运行环境配置里。

这些处理完，再让TRAE用同一个技能拉起Pages本地预览，顺带核查模型能不能连上。

终端里回显的本地地址一打开，整个AI推理故事就能上手玩了。

换掉故事内容，做成自己的作品

改模板不用写代码，自然语言说清楚就行。

比如交代一句：把故事换成“雨夜美术馆撤离画作”，我演夜班修复师，任务是查清画作为什么被转移、再把它安全运走，玩法和内核保持原样。

接到这类要求，TRAE先去读项目里的AGENTS.md，然后按里面的约定调用内置故事创作技能，改故事数据和页面文案；规则引擎不动，还是原来那套。改完刷新本地页面，就能看故事内容和流程对不对得上。

发布上线，把作品分享出去

新故事自己玩着满意了，再让TRAE做上线前那套动作：跑故事验证和生产构建，两项都过了就发到IGA Pages，并打开它返回的预览地址，确认应用打得开。

顺序上，TRAE是先把故事结构验证和生产构建跑完，再把应用发布到IGA Pages。发布结束会给出预览地址，链接发出去，别人点开就能玩。

想长期分享，就到IGA Pages控制台绑一个自定义域名。哪天想换个模型看效果，在AI加速网关控制台切一下就行，应用代码一行都不用动。

*中国大陆加速区域的自定义域名需完成ICP备案。

拿这个模板起步，就能搭出一个真正能上线的AI应用。

了解更多：

• IGA Pages产品介绍 (https://docs.volcengine.com/docs/station-wide-acceleration/what-is-iga-pages?lang=zh)

• IGA Pages集成AI加速网关 (https://docs.volcengine.com/docs/station-wide-acceleration/integrate-ai-accelerated-gateway?lang=zh)

• AI加速网关计费说明 (https://docs.volcengine.com/docs/station-wide-acceleration/ai-accelerated-gateway-billing-overview?lang=zh)