公开 OpenAPI

openapi.json 是面向第三方开发者和编码智能体的精简公开契约，只包含 OAuth、开放用户上下文、Personal/Team 模型目录和模型网关关键接口。

使用方式

https://<platform-host>/developers/openapi.json

可以让编码 AI、IDE 或 OpenAPI 工具读取该文件生成有类型的服务端客户端。生成代码后仍必须遵守以下边界：

• OAuth Token 和 Client Secret 只能保存在可信服务端；
• Personal 与 Team Token 必须隔离；
• Team 模型调用必须携带可信工作流 Header；
• 当前 Team 不支持流式模型调用；
• 不要把完整后台 /openapi.json 当作第三方开放合同。

维护规则

reference/openapi.public.json 是公开 Schema 的仓库源文件。文档构建会先解析校验 JSON，再发布到 /developers/openapi.json。开放接口发生字段、Scope、错误码或 Team Header 变化时，必须在同一轮更新 Schema 和对应 Markdown。