Analytics API
Codex 中文站说明： 本页围绕“Analytics API”重新补充了中文使用场景和验证重点。界面名称可能随 Codex 版本更新，请以当前客户端为准。
了解 Codex Analytics API 的用途和管理边界
Codex Analytics API 为 ChatGPT 工作区提供聚合的 Codex 使用与活动指标。
需要认证的 Codex Analytics API 参考是当前访问要求、路由、request 与 response schema、指标、时间语义和分页行为的事实源。
何时使用 Analytics API
Analytics API 适用于以下需求：
- 自动生成周期性 Codex 报告。
- 把聚合 Codex 指标与组织内部数据关联。
- 为经过批准的受众构建受控报告层。
- 避免让集成与交互式仪表板紧密耦合。
它不是原始审计日志接口。工作流需要可审计活动记录时，请使用 Compliance API。
确认管理边界
Analytics API 结果以 ChatGPT 工作区为作用域，但请求使用 Platform 组织 API key 认证。该 API key 所属组织必须与工作区关联的组织一致。
当前 API key 预配、作用域要求、路由、schema、字段、时间语义和分页行为以认证后的参考为准，本页不重复这份契约。
相关文档
本站实践建议
落地“Analytics API”前，建议先在小范围工作区验证身份、权限和审计策略，再逐步推广到团队。企业策略应同时记录负责人、变更时间和回滚方式。
Codex API 与国内使用
在实践“Analytics API”相关功能时，如需为 Codex 配置 OpenAI-compatible API，可以前往 APIBest 获取 API Key。第三方服务的模型映射、价格、额度和数据处理方式以 APIBest 当前说明为准。