> For the complete documentation index, see [llms.txt](https://docs.console.zenlayer.com/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.console.zenlayer.com/welcome/cn/ai-gateway/create-an-ai-gateway.md).

# 创建 AI 网关

一个 AI 网关就是一把 API 访问密钥，带有自己的模型范围、消费额度、到期时间和 IP 限制。这里的每一项设置创建后都可以在 AI 网关列表中修改。

| 设置项        | 默认值        | 创建后在哪改              |
| ---------- | ---------- | ------------------- |
| 模型接入       | 完整接入       | **操作** > **管理模型接入** |
| 消费额度       | 关闭（不设消费上限） | **操作** > **管理消费额度** |
| API 密钥到期时间 | 长期有效       | **操作** > **管理过期时间** |
| IP 限制      | 关闭         | 网关详情页               |

## 操作步骤

{% stepper %}
{% step %}
**登录**

前往 [**zenConsole**](https://console.zenlayer.com/) 并使用你的账号登录。在左侧菜单栏中，进入 **产品** > **GPU & AI** > **AI 网关**，然后点击 **创建 AI 网关**。
{% endstep %}

{% step %}
**填写基本信息**

* **为 AI 网关命名**：系统会预填一个默认名称，例如 `AI-Gateway-01`，可以直接改成自己的名字。
* **选择资源组**：资源组决定团队中哪些成员可以查看和管理这个网关，也决定它可以使用哪些模型（由管理员在模型访问中设置）。默认为 **Default Resource Group**。详情请参见 [创建资源组](https://docs.console.zenlayer.com/welcome/cn/platform/team-management/create-a-resource-group.md) 和 [管理模型访问](https://docs.console.zenlayer.com/welcome/cn/ai-gateway/manage-model-access.md)。
  {% endstep %}

{% step %}
**设置预算和有效期**

**消费额度** 默认关闭，即不设消费上限。开启后，至少填写以下一项，即可限制该网关的花费：

* **每日金额限额（美元）**
* **月度金额限额（美元）**
* **总金额限制（美元）**

限额按折扣前的 AI 使用总费用计算，实际扣费以折扣后金额为准。达到限额后，网关将停止处理请求，直到你修改限额。

**设置 API 密钥到期时间** 默认为 **长期有效**。为临时访问或项目型访问设置到期时间时，可选 `7 天`、`30 天`、`60 天`、`90 天`，或选择 `自定义` 后在 **自定义密钥有效期** 中指定日期。
{% endstep %}

{% step %}
**配置模型接入**

选择这个 AI 网关可以调用哪些模型。副标题会显示当前可调用的模型数和供应商数，点击模型数可以查看完整列表。

* **完整接入**（默认）：资源组允许的全部模型，之后新允许的模型也自动可用。
* **自定义接入**：点击 **自定义接入** 会直接打开选择器，勾选需要的供应商或单个模型，点击 **确认**。可以按任务类型（大语言模型、文本转语音、文本嵌入、图像生成等）筛选，也可以用搜索框查找供应商或模型。勾选供应商即选中其全部现有模型。确认后，副标题会按供应商列出已选的模型数，点击 **编辑** 可以再次调整。

可选的模型范围由团队管理员在 [模型访问](https://docs.console.zenlayer.com/welcome/cn/ai-gateway/manage-model-access.md) 中按资源组设置。这里只会列出所选资源组允许的模型，管理员放开的受限模型会单独列在 **受限模型** 分组中。如果找不到需要的模型，请联系管理员为该资源组放开。切换资源组后，模型接入会重置为完整接入。

{% hint style="info" %}
创建后仍可随时调整模型接入范围。
{% endhint %}
{% endstep %}

{% step %}
*<mark style="color:green;">**（可选）**</mark>***&#x20;高级设置**

**IP 限制** 默认关闭，任何 IP 均可调用此网关。开启后可以按客户端 IP 地址控制访问，两种模式互斥：

* **白名单**：只有列出的 IP 地址可以调用网关。
* **黑名单**：列出的 IP 地址被拒绝，其他地址均可调用网关。

输入一个或多个 IP 地址，多个地址用 `;` 分隔。

展开 **更多操作（标签管理）** 可以为网关添加 **标签**，最多 20 个。
{% endstep %}

{% step %}
**完成创建**

阅读并同意 Zenlayer 客户协议和 AI Gateway 服务条款。如果模型范围包含 Anthropic 的模型，还需要确认 Anthropic 的合规声明。然后点击 ***创建***。
{% endstep %}
{% endstepper %}

## 结果

创建完成后，你将获得一个 **API 访问密钥** 和用于 API 调用的 **Base URL**。密钥只展示一次，请立即复制并妥善保存。你可以查看 [**API 文档**](https://docs.console.zenlayer.com/api-reference/compute/aig) 了解所有相关 API 接口。

## 下一步操作

点击 AI 网关名称，进入详情页面以查看日志、数据分析和基础信息。

如有需要，你也可以在 **操作** 中执行以下操作：

### 管理模型接入

在 **完整接入** 和 **自定义接入** 之间切换，或在资源组允许的范围内修改已选的模型。

### 管理消费额度

开启或关闭 **消费额度**，填写每日、月度或总金额限额。

### 管理过期时间

选择所需的 API 密钥到期时间。

### 复制 AI 网关

点击 ***复制 AI 网关***，即可创建一个配置相同的 AI 网关。

### 禁用或删除

点击 ***禁用*** 可以让网关停止处理请求但保留配置，之后可以再 ***启用***。如果不再需要该网关，点击 ***删除*** 并输入 `Delete` 确认，删除后所有数据将被清除且无法恢复。
