AI Gateway 快速开始

本章节将指导你在 10 分钟内完成 AI Gateway 的初始化配置，从登录平台到成功调用第一个大模型接口。

前置准备

在开始使用 AI Gateway 之前，请确保你已完成以下准备：

拥有云器平台企业账号（个人账号无法使用企业级 AI Gateway 服务）
已完成企业实名认证
已开通 AI Gateway 服务

登录云器总控制台

打开浏览器，访问云器平台官方网站：
- 生产地址：https://yunqi.tech/
点击页面右上角的登录按钮
在登录页面，输入你的企业账号和密码，点击"登录"
登录成功后，系统将自动跳转至云器平台账户主页

创建第一个 API Key

API Key 是调用 AI Gateway 服务的唯一身份凭证，所有模型调用请求都需要携带有效的 API Key 进行身份验证。

在云器平台账户主页，找到 AI Gateway 服务卡片，点击并进入产品页面
进入 AI Gateway 产品界面后，系统默认展示 API KEY 管理 页面
点击页面右上角的新建按钮
在弹出的 新建 API KEY 对话框中，依次填写以下信息：
- 名称：输入 API Key 的标识名称，建议采用"业务线-环境-用途"的命名规范，例如"客服系统-生产-通用对话"
- 限额周期：从下拉菜单中选择 Token 限额的重置周期，支持以下四种选项：
  - 天：每日 0 点自动重置 Token 限额
  - 自然周：每周一 0 点自动重置 Token 限额
  - 月：每月 1 日 0 点自动重置 Token 限额
  - 长期有效：Token 限额永久有效，不会自动重置，用完即止
- Token 限额：输入该周期内允许消耗的最大 Token 数量
确认信息无误后，点击对话框右下角的确定按钮
系统将自动生成 API Key 并显示在列表中，点击 API Key 列的眼睛图标可查看完整的密钥字符串

⚠️ 注意：切勿将 API Key 泄露给他人，也不要将其硬编码在代码中或提交到公共代码仓库。如发现 API Key 泄露，请立即在控制台吊销该密钥并重新生成。

配置路由策略（可选）

路由策略决定了你的 API Key 可以调用哪些模型，以及模型调用的优先级。默认情况下，新创建的 API Key 可以调用平台提供的所有内置模型，并采用"价格优先"的排序策略。

如果你需要使用自定义的路由策略或 BYOK 模型，请按照以下步骤配置：

在 API Key 列表中，找到你刚刚创建的 API Key
点击操作列中的 路由策略 按钮
在弹出的 路由策略配置 对话框中，你可以进行以下配置：

方式一：使用平台内置模型（默认）

供应商范围：
- 全部供应商（默认）：可以使用平台提供的所有内置模型
- 选择特定供应商：勾选你需要使用的供应商，仅可以使用这些供应商提供的模型
供应商排序策略：
- 价格优先：优先调用价格最低的可用供应商
- 吞吐优先：优先调用吞吐量最高的可用供应商
- 延迟优先：优先调用延迟最低的可用供应商

方式二：仅使用自己的 BYOK 模型

勾选 仅使用我的 BYOK Key 复选框
从下拉列表中选择你已创建的 BYOK Key（如未创建 BYOK Key，请先参考相关文档完成创建）
勾选后，该 API Key 将只能调用你绑定的 BYOK 模型，账单将直接走你自己的供应商账户

配置完成后，点击对话框右下角的保存按钮

测试模型调用

完成以上配置后，你就可以使用创建的 API Key 调用大模型接口了。你可以使用兼容 OpenAI 或 Anthropic 接口的客户端或 SDK 进行调用。

以 Qwen3.6 Plus 为例，以下是两种最常用的调用方式：

方式一：使用 curl 命令调用

打开终端，执行以下 curl 命令，将

YOUR_API_KEY

YOUR_API_KEY

替换为你实际的 API Key：

curl -X POST https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions \ -H "Authorization: Bearer $API_KEY" \ -H "Content-Type: application/json" \ -d '{ "model": "qwen/qwen3.6-plus", "messages": [{"role":"user","content":"hello"}] }'

方式二：使用 Python 调用

import requests url = "https://cn-shanghai-alicloud-aimesh.api.clickzetta.com/gateway/v1/chat/completions" headers = { "Authorization": "Bearer ${API_KEY}", "Content-Type": "application/json", } payload = { "model": "qwen/qwen3.6-plus", "messages": [{"role": "user", "content": "hello"}], } resp = requests.post(url, headers=headers, json=payload, timeout=60) print(resp.status_code) print(resp.text)

成功返回示例

如果调用成功，你将看到类似以下的返回结果：

{"text":"Hello! How can I help you today?","type":"text"}