服务概述
更新时间:2026-09-20
什么是服务
服务(Service)是 API 的归属与组织单元,一个服务下可以包含多个 API(路由)。客户端通过服务绑定的域名(或实例访问地址)访问服务下的 API,网关根据 API 的匹配规则将请求转发至对应的后端。
服务类型
API 网关专享版支持三种服务类型,各类型的创建、管理与监控能力按模块分别说明:
| 服务类型 | 说明 | 承载的 API | 文档 |
|---|---|---|---|
| 基础服务(HTTP_SERVICE) | 面向通用 API 代理场景,支持 HTTP 与 WebSocket 协议。 | 基础 API | 基础服务 |
| Model 服务(MODEL_SERVICE) | 面向大模型调用场景,支持多种模型场景与协议。 | Model API | Model 服务 |
| Agent 服务(AGENT_SERVICE) | 面向 Agent 应用代理场景,支持 HTTP 与 WebSocket 协议。 | Agent API | Agent 服务 |
三类服务的能力对比
| 能力 | 基础服务 | Model 服务 | Agent 服务 |
|---|---|---|---|
| 模型场景与服务协议 | 不涉及 | 支持 | 不涉及 |
| Base Path | 不涉及 | 支持 | 不涉及 |
| 绑定自定义域名 | 支持 | 支持 | 支持 |
| 消费者认证 | 支持 | 支持 | 支持 |
| 监控聚合维度 | 域名、API | 域名、模型 | 域名、API |
| AI 指标(Token 等) | 不涉及 | 支持 | 支持 |
前提条件
通用说明
以下能力三类服务表现一致,各模块文档中均有说明:
- 默认域名:每个服务都有默认的公网/私网访问域名,仅供测试,网关侧限制单日调用次数不超过 1000 次;生产环境请绑定自定义域名。
- 消费者认证:服务级别开启认证后,该服务下全部 API 的流量默认拒绝,仅放行已授权消费者;API 侧单独开启时以 API 侧为准,详见授权管理。
- 删除约束:删除服务会同步删除服务下的所有 API,且不可恢复。
- 监控入口:服务详情的「监控」标签页查看该服务的业务指标,指标口径详见业务监控。
相关操作
基础服务
Model 服务
Agent 服务
其他
- API 概述:了解服务下三类 API 的能力差异。
评价此篇文章
