火山引擎IGA Pages：大模型接入如何免配Key免搭代理？

给Web应用接大模型，一般得先把服务端调用链路搭起来。

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

事情还没完。这层代理得单独部署、单独维护。写页面、写业务逻辑之外，模型服务、服务端运行环境、托管平台，开发者要各管一摊。

火山引擎全站加速产品体系下有一项Web应用托管和部署能力，叫IGA Pages。它现在已经把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说：

用IGA一键部署技能，就能以“AI推理任务 · 静默航线”模板为基础建一个叫my-mystery-story的项目：IGA Pages云端项目创建并关联、接入AI加速网关、本地与远端模型配置同步，一次做完。

这套流程由TRAE调用IGA一键部署技能执行：先把模板里的完整项目代码拉到本地，接着在IGA Pages上建好远端项目并完成关联。

1. 随后，它会在账号下新建Pages专属AI加速网关实例；已有实例则直接复用。

1. 模型服务地址和API Key会被写进本地和远端两边的环境配置。

到这里，再让TRAE启动本地预览：同样调用IGA一键部署技能，拉起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)