支持文档产品化中
Gateway 状态与支持
Gateway 模型可用性、错误码、限流、状态语义和支持排查证据的公开边界。
当前公开承诺
| 主题 | 现在可以承诺 | 仍在完善 |
|---|---|---|
| Models | Gateway 暴露 OpenAI-compatible 模型调用入口 | 公开模型列表、模型别名、上下文长度和可用性说明 |
| Errors | 错误应包含稳定 code、message 和 request id | 常见鉴权、模型、额度、限流、provider 降级错误表 |
| Rate limits | 额度和限流由 Gateway 统一治理 | 每 key、团队、组织维度的可见额度和重置时间 |
| Status | API 入口已上线 | 公开状态页、provider 健康、降级语义和维护公告 |
错误分流
| 错误类型 | 先检查 | 支持证据 |
|---|---|---|
| 鉴权失败 | Authorization header、key 归属、是否误用 TokenDance ID token | 状态码、error code、request id、请求时间 |
| 模型不存在 | model 名称、别名、key 是否具备访问权限 | 模型名、request id、SDK 配置 |
| 额度或限流 | key owner、额度、并发、重置窗口 | 状态码、error code、时间窗口、客户端类型 |
| Provider 降级 | 模型名、重试策略、是否有降级公告 | request id、时间、脱敏任务描述 |
| 请求格式错误 | messages、tools、stream、payload schema | SDK 版本、脱敏 payload 结构 |
支持时提供什么
- 请求时间、HTTP 状态码、error code、request id、模型名。
- SDK 名称与版本、base URL 是否为 https://api.vectorcontrol.tech/v1。
- 客户端类型：AgentHub、TokenDanceCode、CI、后端服务或本地脚本。
- 脱敏任务场景，不提交真实 key、完整 prompt、私有文件、完整 provider response。
状态页方向
公开状态页和模型可用性页面仍在产品化中。在正式状态页上线前，公开文档只能承诺 API 入口、凭据边界、占位 SDK 示例和支持证据要求；不要写企业 SLA、全量模型清单或自动降级承诺。
与 TokenDance ID 的边界
- TokenDance ID 登录证明人或组织身份，不是模型 API 鉴权。
- TokenDance API key 用于 Gateway 模型 API 调用，不用于登录 TokenDance ID。
- 管理 UX、key 自助、额度/用量视图仍在完善，公开文档不应暗示完整自助后台已经发布。