沙箱
沙箱 API
我们的沙箱 API 只有一个版本：v1。每个功能一个接口，形状是 E2B 该功能当前最新版本，但官方 E2B SDK 不能未经修改直接指向这里——按下面每个端点自带的示例直接发请求即可。
基础地址
加载中…
接入
加载中…HTTP 与 SDK 接入
用 HTTP 直接调用 /sandbox/v1，请求携带 X-API-Key。官方 E2B SDK 请使用 E2B 兼容接口，不能只修改 API 地址来调用这里的接口。
HTTP 基础地址：。
端点
| 方法 | 路径 | 说明 | 支持 |
|---|---|---|---|
| POST | /v1/sandboxes | 创建沙箱 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/upgrade | 升级为完整沙箱 | ● 支持 |
| GET | /v1/sandboxes | 列出沙箱 | ● 支持 |
| GET | /v1/sandboxes/{sandboxID} | 读取沙箱 | ● 支持 |
| PATCH | /v1/sandboxes/{sandboxID} | 重命名沙箱 | ● 支持 |
| GET | /v1/sandboxes/{sandboxID}/metrics | 沙箱指标 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/timeout | 设置超时 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/pause | 暂停沙箱 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/connect | 连接沙箱 | ● 支持 |
| DELETE | /v1/sandboxes/{sandboxID} | 终止沙箱 | ● 支持 |
| GET | /v1/templates | 列出模板 | ● 支持 |
| POST | /v1/volumes | 创建卷 | ● 支持 |
| GET | /v1/volumes | 列出卷 | ● 支持 |
| GET | /v1/volumes/{volumeID} | 读取卷 | ● 支持 |
| DELETE | /v1/volumes/{volumeID} | 删除卷 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/fork | 复制沙箱 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/snapshots | 创建快照 | ● 支持 |
| GET | /v1/snapshots | 列出快照 | ● 支持 |
| DELETE | /v1/snapshots/{snapshotID} | 删除快照 | ● 支持 |
| PUT | /v1/sandboxes/{sandboxID}/network | 更新网络策略 | ● 支持 |
| GET | /v1/sandboxes/{sandboxID}/logs | 读取沙箱日志 | ● 支持 |
| POST | /v1/sandboxes/{sandboxID}/extend | 延长沙箱 | ● 支持 |
| GET | /v1/sandboxes/{sandboxID}/processes | 列出进程 | ● 支持 |
| GET | /v1/sandboxes/{sandboxID}/processes/{processID}/output | 读取输出 | ● 支持 |
与官方的差异
- 快照使用本平台 snap_ 开头的 ID，可作为创建沙箱的 templateID。旧供应商句柄不再接受。暂停的沙箱用「连接沙箱」恢复运行。
- 仅提供本页声明的端点，webhooks 等未采纳的端点返回 404。
- 创建沙箱：平台暂未提供 E2B 默认的 base 模板：不带模板参数的 Sandbox.create() 会返回 404，请显式指定模板（可用模板见「列出模板」）。
参数与字段的权威定义以 E2B 官方文档为准。