发布与管理ModelAPI

更新时间：2026-09-21

概述

Model API 的发布与禁用在 匹配规则粒度 进行。本文介绍 Model API 的查看、编辑、删除、匹配规则管理与消费者认证管理操作。

进入目标实例的 API 管理 > Model API 查看列表。

列	说明
API 名称/ID	API 标识。单击名称可进入 API 详情页。
路径	路由的匹配路径。
优先级	API 的匹配优先级（0-9999，0 为最高）。
关联 Model 服务	API 归属的服务信息。
匹配规则	单击可展开该 API 的图形化请求处理链路，查看并管理各条匹配规则。
更新时间	API 最近一次的更新时间。
操作	提供「编辑」「删除」入口。发布与禁用在匹配规则粒度进行。

说明：对于创建 Model 服务时选择预置路由联动创建的默认 API，不支持单独编辑，需要通过编辑 Model 服务进行修改。

在 API 列表中对不再使用的 API 执行删除，会联动删除该 API 下的全部匹配规则，二次确认提示「该操作将删除 API 以及 API 的所有匹配规则，且不可恢复」。

在 API 列表中单击 匹配规则，或进入 API 详情页，可查看图形化的请求处理链路，自左向右依次为：

Plain Text

1API（匹配条件）→ 安全防护 → 策略与插件 → 模型匹配规则 → Fallback 服务

节点	展示内容
API	请求入口的匹配条件：Path、Method、Header、Query。多个 API 同时满足时按优先级生效。
安全防护	该 API 的消费者认证开启状态。
策略与插件	按作用在该 API 上的生效顺序编号展示策略与插件，含系统插件、平台插件与自定义插件。
模型匹配规则	按后端策略生成的匹配规则列表，每条规则展示上线状态（已发布 / 已禁用）、匹配条件与命中的后端服务（按比例策略下附带权重）。
Fallback 服务	API 级别的兜底后端，按生效顺序编号展示。不支持在链路图中操作，需通过编辑 API 修改。

链路图右上角提供放大、缩小、自适应与全屏按钮，画布支持拖动。

单击规则卡片右上角的 ··· 展开操作面板：

操作	说明
发布	将已禁用的规则重新置为发布状态，规则重新开始承接流量。
禁用	将已发布的规则置为禁用，二次确认提示「匹配规则禁用后，该规则不再生效，请确保已告知用户」。禁用后规则整体置灰并排在所有规则最下方。
删除	删除该匹配规则，二次确认提示「删除后将不可恢复」。仅「按模型名称」策略生成的规则支持删除。

说明：

由创建 API 时联动生成的匹配规则不支持直接编辑，需通过编辑 API 修改。

规则粒度的禁用可用于快速摘除某个模型分组，不影响同一 API 下的其他规则。

API 详情提供 消费者认证 标签页，包含两个区域：

区域	说明
所属服务	只读展示所属服务的消费者认证开启状态、认证方式与已绑定的消费者列表，不支持在此修改。
API	展示并管理 API 自身的消费者认证，右上角标识当前配置是否「生效中」。

在 API 区域可执行以下操作：

操作	说明
开启消费者认证	打开开关后在弹窗中选择认证方式（API_KEY / AK_SK），确认后开启。开启后该 API 的流量默认全部拒绝，仅放行已绑定且启用的消费者。
关闭消费者认证	关闭开关，二次确认提示「关闭后，所有流量将放行，已绑定的消费者不会被删除」。
绑定消费者	认证开启状态下可绑定消费者；未开启认证时绑定入口不可用。
禁用/启用消费者	禁用后该消费者立即失效，原认证凭证将无法调用 API；启用后立即恢复。
解绑	解除该消费者与当前 API 的绑定关系。

说明：API 侧开启认证后优先级高于所属服务，完整的生效优先级说明详见授权管理。