# 版本 (/docs/api/versioning)



版本号写在地址里，紧跟第一段；每个前缀各自计版本，没有全站统一的版本号。

## 地址里的版本段 [#地址里的版本段]

```
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**：端点页标有「Beta」。可能随时改动，不做兼容承诺；适合试用，不建议放进生产。
* **正式**：破坏性变更只会以新版本段发布（如 `/model/v2/…`），旧版本继续可用。

## 弃用怎么通知 [#弃用怎么通知]

旧版本或端点弃用时：

1. 更新日志公告，并给出替代方案；
2. 该端点的响应带两个标准头：`Deprecation`（RFC 9745，何时弃用）与 `Sunset`（RFC 8594，何时下线），`Link` 头指向迁移说明；
3. 从公告到下线至少 **90 天**；下线后返回 `404`。

```
Deprecation: @1767225600
Sunset: Sat, 04 Apr 2026 00:00:00 GMT
Link: </docs/changelog>; rel="deprecation"
```