统一接入多家图片 / 视频生成模型,以 OpenAI 兼容协议对外,业务方零改动切换供应商
一、前提条件
·已创建 AI 网关实例。
·已准备对应模型供应商的凭证(如 API Key 等)。
二、步骤1:新建模型服务
1. 登录 AI 网关控制台,单击实例管理 > 目标实例详情页。
2. 进入 模型管理 > 模型服务,单击新建。
3. 在“基本信息”步骤填写以下参数:
·服务名称:填写服务名称(60 字符内)。
·服务类型:固定为“AI 模型服务”。
·模型供应商:从下拉选择供应商,如 Hunyuan / OpenAI / Qwen(DashScope) / 可灵开放平台/ 自定义。
·模型协议:根据所选供应商动态过滤后选择,如 OpenAI 兼容 / DashScope / Kling
·服务地址:填写供应商原生 Base URL。
·模型密钥:引用已有模型密钥,或单击新建密钥创建。
·密钥使用策略:选择多 Key 分配策略(如轮询)。
·描述:填写描述(选填,200 字符内)。
·高级配置:按需展开填写(选填)。
4. 单击下一步,进入“选择模型策略”步骤:
·选择 透传:不配置模型列表,客户端请求体 model 字段直接透传给上游。
·选择 指定:在穿梭框中按场景分组勾选内置模型。
5. 单击保存,完成模型服务创建。
三、步骤2:新建图片生成模型 API
1. 进入 模型管理 > 模型 API,单击新建模型 API。
2. 在“基本信息”步骤填写以下参数
·API 名称:填写 API 名称,如“营销配图 API”。
·使用场景:选择卡片 图片生成。
·请求协议:按场景选择(单选):OpenAI 兼容 / DashScope / 腾讯云 TC3 / Gemini / Kling OpenAPI。
·路由:勾选启用的端点。主端点 POST /v1/images/generations 不可取消
·Base Path:填写以 / 开头的 Base Path。
·Header:按需添加自定义 Header(选填)。
·描述:填写描述(选填)。
3. 单击下一步,进入“选择模型服务”步骤:
·主模型服务:从已选服务中指定一个作为默认路由目标。
·跨服务 Fallback:按需开启,主服务失败时按顺序降级到备用服务(选填)。
4. 单击保存,完成模型 API 创建。
注意:关联模型服务:仅可选“模型协议”与第一步“请求协议”一致的服务,不匹配的服务置灰禁用并提示“协议不匹配”。
四、步骤3:新建视频生成模型 API
1. 进入模型管理 > 模型 API,单击新建模型 API。
2. 在“基本信息”步骤填写以下参数:
·API 名称:填写 API 名称,如“短视频生成 API”。
·使用场景:选择卡片 视频生成。
·请求协议:按场景选择(单选):Kling OpenAPI / Vidu
·路由:POST /v1/videos/generations 与查询端点 GET /v1/videos/tasks/{id} 等
·Base Path:填写以 / 开头的 Base Path。
3. 单击下一步,在“选择模型服务”步骤选择协议一致的服务(规则同图片生成)。
4. 单击保存,完成模型 API 创建。