版本
版本在地址里，跟着第一段走；弃用提前 90 天，用两个标准头告诉你。
版本号写在地址里，紧跟第一段；每个前缀各自计版本，没有全站统一的版本号。
地址里的版本段
https://api.deepraxis.ai/{protocol}/{version}/…| 前缀 | 版本段 | 由谁决定 |
|---|---|---|
/openai /anthropic | v1 | 跟随厂商 |
/google | v1beta | 跟随厂商 |
/e2b /tavily | 无版本段 | 跟随厂商 |
/agent /model /sandbox /search /meta | v1 | Praxis |
厂商前缀下，版本相关的头（如 Anthropic 的 anthropic-version）原样透传给厂商，行为与官方一致。
什么算破坏性变更
删字段、改字段类型或含义、改默认值、收紧校验、改错误码含义。加字段、加端点、放宽校验不算。
Beta 与正式
- Beta：端点页标有「Beta」。可能随时改动，不做兼容承诺；适合试用，不建议放进生产。
- 正式：破坏性变更只会以新版本段发布（如
/model/v2/…），旧版本继续可用。
弃用怎么通知
旧版本或端点弃用时：
- 更新日志公告，并给出替代方案；
- 该端点的响应带两个标准头：
Deprecation（RFC 9745，何时弃用）与Sunset（RFC 8594，何时下线），Link头指向迁移说明； - 从公告到下线至少 90 天；下线后返回
404。
Deprecation: @1767225600
Sunset: Sat, 04 Apr 2026 00:00:00 GMT
Link: </docs/changelog>; rel="deprecation"