产品概述
ZStack API Router 是企业 AI 模型统一接入网关，提供模型访问、渠道路由、令牌管理、用量计量、审计追踪和健康观测能力。管理员可通过控制台或控制面 API 完成模型供应商接入和组织权限配置，开发者可使用 OpenAI 兼容接口调用模型。
典型使用闭环如下：
- 初始化网关并确认服务就绪。
- 创建组织、用户和模型访问范围。
- 创建令牌。
- 配置渠道并同步模型。
- 启用模型并配置路由策略。
- 使用 API Key 调用模型。
- 查看用量日志、审计日志、健康状态和指标。
- 根据日志和指标排查调用问题。
主要对象
| 对象 | 说明 |
|---|---|
| 用户 | 使用控制台或调用模型的人员账号。 |
| 组织 | 成本、模型访问和用量归属的管理边界。 |
| 令牌（Token） | 调用凭证的管理对象。创建令牌后，系统生成 API Key 明文，业务系统使用 API Key 调用模型。 |
| 渠道 | 连接到上游模型服务的访问出口。 |
| 模型 | 业务调用时填写的模型名称。 |
| 路由策略（Route Policy） | 按模型、组织或业务规则选择渠道的规则。 |
| 用量日志（Usage Log） | 记录模型调用、用量、状态和耗时。 |
| 审计日志（Audit Log） | 记录管理操作和资源变更。 |
创建令牌后，系统生成 API Key 明文。API Key 明文只在创建完成后展示一次，并只应交付给调用方。后续排查时请使用令牌 ID、令牌名称、用户和组织信息定位，不要在工单、截图或日志中粘贴真实密钥。