本教程介绍了如何快速开始使用边缘大模型网关。

前提条件

您已经注册火山引擎账号并完成实名认证。更多信息，请参见实名认证。

配置流程

您可以参照以下步骤使用边缘大模型网关：

1. 创建网关访问密钥。
   网关访问密钥是您访问边缘大模型网关 API 的凭证。
2. 调用边缘大模型网关 API。
   边缘大模型网关提供与 OpenAI API 用法完全一致的 API 和 SDK。您只需复制示例代码并使用 OpenAI 请求方法编写请求，即可访问各种支持的模型或智能体。
3. 监控资源消耗。
   随时监控网关访问密钥的用量（如 Token），以免额度不足导致调用失败。

步骤1：创建网关访问密钥

1. 登录边缘大模型网关控制台。

2. 在左侧导航栏，选择 网关访问密钥 > 通用密钥。
3. 在 后付费密钥 标签页，单击 创建通用密钥。
4. 在 边缘大模型网关后付费密钥 页面，阅读并同意协议，然后单击 立即购买。
   
5. 确认订单信息后，单击 提交。
6. 返回控制台，在网关访问密钥列表找到新创建的后付费密钥，单击密钥名称。
7. 在弹出的对话框中，单击 立即编辑。
   
8. 完成 编辑网关访问密钥 配置向导。

   1. 创建网关访问密钥。
      完成以下参数配置，然后单击 下一步：调用配置。
      

      配置项	说明
      名称	修改网关访问密钥的显示名称。示例：my_first_key。
      模型选择	单击 新增模型/智能体，然后从模型/智能体列表中选择与该网关访问密钥绑定的模型和智能体。网关访问密钥只能用于调用与它绑定的模型和智能体。 在本教程中，推荐选择平台预置模型。您可以将 渠道类型 设置为 平台预置模型，以筛选出所有可用的预置模型。

   2. 调用配置。
      完成以下参数配置，然后单击 确定。
      

      配置项	说明
      调用顺序	手动调整上一步选择的模型的顺序。 前一个模型调用失败后，边缘大模型网关将依次调用后续模型，直到成功调用一个模型。如果所有模型都调用失败，则返回错误响应。
      重试次数	默认值为 0，表示当一个模型调用失败后，边缘大模型网关不进行重试。如果需要让边缘大模型网关进行重试，可以指定重试次数。

      首次配置时，无需修改 高级配置。更详细的参数说明，请参见创建网关访问密钥。

网关访问密钥配置成功后，在列表找到您的网关访问密钥，单击 操作 列的 查看密钥。您可以在弹出的对话框中查看和复制相应的 API Key。

步骤2：调用边缘大模型网关 API

在列表找到您的网关访问密钥，单击 操作 列的 查看代码。查看代码 对话框提供了符合 OpenAI 接口请求规范的示例，如 Curl、Python 示例。
使用示例代码时，注意以下事项：

• 通过 选择模型 参数指定要调用的模型或智能体。
  您可以从网关访问密钥绑定的模型和智能体中选择一个模型或智能体。您选择模型或智能体后，代码中的model参数值将自动替换成模型或智能体对应的值。
• 使用您的网关访问密钥 API Key 替换示例代码中的$VEI_API_KEY。
  

步骤3：监控用量

在网关访问密钥列表找到您的网关访问密钥，查看 平台预置渠道用量（Token）。

• 调用平台预置模型或智能体将优先消耗网关访问密钥的免费资源额度。更多信息，请参见使用限制。

• 默认展示了 Token 用量。您可以将光标放置在 平台预置渠道用量（Token） 数值上，查看其他计量方式对应的用量情况。