AI 加速网关是火山引擎全站加速（DCDN）提供的模型调用代理服务，帮助应用统一管理和调用大模型 API。关于 AI 加速网关的完整功能介绍，请参见 什么是 AI 加速网关。

您在创建 IGA Pages 项目时，可以启用 AI 加速网关为应用接入模型调用能力；已有项目也可以在项目详情中绑定网关。启用后，系统会向项目注入模型服务地址和 API Key，应用直接读取即可调用模型，无需手动配置连接信息。

背景信息 #

IGA Pages 通过 AI 加速网关为应用提供模型调用能力。当您启用该功能时，系统会为当前账号创建一个 Pages 专属 AI 加速网关实例；如果账号下已有专属实例，则直接复用。该实例由账号下所有 Pages 项目共享，每个项目最多绑定一个网关实例。

系统将网关实例绑定到 Pages 项目后，会自动注入以下环境变量：

• AI_GATEWAY_BASE_URL：模型服务地址。
• AI_GATEWAY_API_KEY：调用模型服务的 API Key。

应用在运行时读取这两个环境变量，即可通过网关调用模型服务。AI 加速网关兼容 OpenAI 协议，支持平台免费模型和用户自有模型。

计费与免费额度 #

AI 加速网关为每个账号提供 50 万 Token 免费额度，由账号下所有 Pages 项目共享。免费额度仅用于调用平台免费模型，您可以直接使用免费模型验证应用，无需额外配置。免费模型范围以控制台实际展示为准。

免费额度即将用尽时，控制台会显示提醒。额度耗尽后，免费模型将无法调用——您可以为网关实例配置自有模型继续使用 AI 能力。自有模型调用不消耗赠送额度，费用由对应模型供应商结算。

Pages 专属网关实例免收网关流量费和请求数费。完整计费规则请参见 AI 加速网关计费说明。

前提条件 #

接入前，请确认满足以下条件：

• 已完成火山引擎账号实名认证。
• 已开通智能全球加速服务。
• 如需为已有项目绑定网关，已创建 IGA Pages 项目。

接入 AI 加速网关 #

创建项目时接入 #

1. 登录全站加速控制台。

2. 进入 服务概览 > Pages，单击 创建项目。

3. 在 大模型配置 中启用 AI 加速网关。按需使用平台免费模型，或配置自有模型。
   平台免费模型无需配置，默认启用；自有模型的配置说明，请参见 模型配置说明。

   

4. 完成其他项目配置并创建项目。

Pages 会创建或复用账号下的 Pages 专属网关实例，绑定当前项目并注入环境变量。首次部署会直接包含该配置，无需再执行重新部署。其他创建参数，请参见 创建 IGA Pages 项目。

为已有项目绑定 #

如果您在创建项目时未启用 AI 加速网关，也可以为已有项目绑定网关实例。

1. 登录全站加速控制台，进入 服务概览 > Pages，选择需要接入网关的项目。

2. 在项目详情页选择 拓展能力 标签页，找到 AI 加速网关 区域。

3. 单击 新建绑定，选择可用的 AI 加速网关实例，然后单击 确认绑定。
   

   绑定后，系统自动为项目关联 AI_GATEWAY_BASE_URL 和 AI_GATEWAY_API_KEY 环境变量。

4. 进入项目详情页的 部署记录，选择一条部署记录并执行重新部署，使新配置生效。
   
   具体操作，请参见 重新部署。

5. 部署完成后，在项目详情中确认网关实例已绑定、环境变量已注入。

如需了解普通环境变量的配置方式，请参见 设置环境变量。

管理已接入的 AI 加速网关 #

查看接入状态和共享额度 #

进入项目详情页的 拓展能力 > AI 加速网关，查看已绑定的网关实例、模型来源和关联环境变量。Pages 控制台还会显示账号共享赠送额度的剩余 Token 和额度状态。

管理模型 #

免费额度不足或需要使用特定模型时，可以为网关实例配置自有模型。在项目详情页的 拓展能力 > AI 加速网关 中，单击网关实例 ID 旁边的跳转图标，进入网关实例详情，完成自有模型和密钥配置。具体操作，请参见 查看和管理实例。

配置完成后，应用即可通过同一网关实例调用自有模型。自有模型调用不消耗赠送额度，同时您仍可继续调用平台免费模型。

如果不再需要 AI 能力，在 拓展能力 > AI 加速网关 中解除绑定，并重新部署项目使变更生效。解除绑定会移除关联的环境变量，但不会删除网关实例。