本文以「通过 API 网关专享版统一代理大模型服务」为例，介绍从创建实例到完成第一次模型调用的完整流程。

前提条件

• 已注册百度智能云账号并完成实名认证。
• 账户余额充足（API 网关专享版为按量付费产品）。
• 首次使用时，请根据页面引导完成产品开通。
• 已获取模型供应商的服务地址与 API-Key。

步骤一：创建网关实例

1. 登录 API 网关专享版控制台，在左上角选择地域（如华北-北京）。
2. 进入 实例管理 页面，单击 创建网关实例。

3. 按分步表单完成配置：

   • 基本信息：计费方式选择「按量付费」。
   • 网关规格：填写网关名称，选择实例规格。
   • 网络配置：选择网络访问类型（公有 / 私有 / 公有+私有），配置 EIP 或 VPC 服务网卡。
   • 日志配置：按需开启 BLS 日志服务。
   • 订单确认：核对配置与价格后提交。
4. 等待实例状态从「创建中」变为「运行中」，创建过程可能需要几分钟时间。

详细参数说明参见创建实例。

步骤二：创建后端

1. 在左侧导航选择目标实例，进入 后端管理，单击 创建后端。

2. 后端类型选择 AI 模型后端，配置：

   • 大模型供应商与模型协议（OpenAI 兼容 / Anthropic 兼容 / 原生协议）。
   • 服务地址（模型服务的 Endpoint）。
   • 大模型 API-Key（托管在网关侧，调用方不可见）。
3. 提交创建。

详细参数说明参见创建 AI 模型后端。

步骤三：创建 Model 服务

1. 进入 服务管理 > Model 服务，单击创建。
2. 填写服务名称，选择模型场景（如「文本生成」）与服务协议（如「OpenAI 兼容」）。
3. 勾选需要开启的预置路由（如 POST /v1/chat/completions）。
4. 按需绑定自定义域名后提交。

详细参数说明参见创建 Model 服务。

步骤四：创建 Model API 并发布

1. 进入 API 管理 > Model API，单击创建。
2. 选择步骤三创建的 Model 服务。
3. 选择路径，并配置匹配条件。

4. 配置后端策略：

   • 单后端：直接选择步骤二创建的后端。
   • 多后端（按模型名称 / 按比例）：配置多个后端及路由规则。
5. 按需开启 Fallback 兜底配置。
6. 提交后 发布 API。

详细参数说明参见创建 Model API。

步骤五：创建消费者并授权（可选）

如需对调用方进行身份认证与管控：

1. 进入 消费者管理，创建消费者，获取 API-KEY 或 AK/SK 凭证。
2. 进入消费者详情的 授权管理，新增授权：选择实例 → 服务（服务级别授权）或具体 API（API 级别授权）。

详细操作参见创建消费者与授权管理。

步骤六：发起调用

使用服务绑定的域名（或实例访问地址）发起请求，以 OpenAI 兼容协议为例：

1curl -X POST 'https://{网关访问地址}/v1/chat/completions' \
2  -H 'Content-Type: application/json' \
3  -H 'Authorization: Bearer {消费者API-KEY}' \
4  -d '{
5    "model": "your-model-name",
6    "messages": [{"role": "user", "content": "你好"}]
7  }'

如使用 OpenAI 官方 SDK，可将 base_url 指向网关：

1from openai import OpenAI
2
3client = OpenAI(
4    base_url="https://{网关访问地址}/v1",
5    api_key="{消费者API-KEY}"  # 网关侧消费者凭证，非模型供应商的真实 API-Key
6)
7resp = client.chat.completions.create(
8    model="your-model-name",
9    messages=[{"role": "user", "content": "你好"}]
10)
11print(resp.choices[0].message.content)

请求正常返回模型响应，说明网关代理链路已打通。客户端全程只持有网关分发的消费者凭证，模型供应商的真实 API-Key 始终托管在网关侧。

后续操作

• 在观测与分析中查看资源监控、业务监控、调用链与日志。
• 在插件市场中为实例或 API 安装流量管控、认证等插件。
• 在消费者详情中配置配额管理与查看费用信息。
• 在域名管理中为服务绑定自定义域名。
• 参考最佳实践了解多模型路由、灰度发布、成本分摊等典型用法。