创建AI云沙盒

POST https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/{workspace_id}/sandboxes

请求头（Request Header）

请参考API 使用指南

请求参数（Request Parameters）

名称	类型	必须	位置	描述
workspace_id	string	是	path	工作空间id，获取方式可以参考快速开始
name	string	否	body	沙盒名称，支持中文英文数字，不超过30字符
description	string	否	body	沙盒描述
snapshot	object	是	body	使用快照
volumes	array[objcet]	否	body	挂载存储
environment	object	否	body	环境变量（键值对）
auto_delete_after	integer	否	body	自动删除时长，单位为秒，即从沙盒创建，存活设定时长后系统自动删除该沙盒，取值范围为-1或者[300,86400],默认值为86400，即默认24小时后删除该沙盒，传入-1则沙盒一直保留，不自动删除

其中，snapshot的参数如下：

名称	类型	必须	描述
id	string	是	快照ID

其中,volumes每个元素参数如下：

名称	类型	必须	描述
type	string	否	卷类型，值可为VOLUME_TYPE_AFS（挂载文件存储）, VOLUME_TYPE_AOSS（挂载对象存储）
afs	object	否	afs文件存储卷信息，当type为VOLUME_TYPE_AFS时不为空
aoss	object	否	aoss存储桶信息，当type为VOLUME_TYPE_AOSS时不为空

其中,afs每个元素参数如下：

名称	类型	必须	描述
volume_id	string	否	卷ID
source_path	string	否	NFS 源路径（主机端路径）
target_path	string	否	容器内挂载路径（目标路径）

其中，aoss每个元素参数如下：

名称	类型	必须	描述
bucket	string	否	存储桶名称
endpoint	string	否	桶的Endpoint
access_key	string	否	密钥ID
secret_key	string	否	密钥
target_path	string	否	沙盒内挂载路径
mount_options	string	否	挂载高级配置参数，多个参数间用空格链接。当前仅支持通过 GeeseFS 挂载 AOSS 时的相关配置，具体参考对象存储AOSS文档。 示例：--no-preload-dir --uid=1000 其中 no-preload-dir 表示关闭预加载功能，uid=1000 表示设置文件所有者为用户ID1000

请求示例（Request Example）

curl -L -X POST 'https://sandbox.cn-sh-01.sensecoreapi.cn/studio/sandbox/v1/workspaces/01993ca4-edfa-7382-8161-43a4919681ab/sandboxes' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer <TOKEN>' \
--data-raw '{
    "snapshot":{
        "id":"18494045-1b93-4054-b072-d9f8055c32ce"
    }
}'

响应（Response）

异常情况请参考异常响应说明

字段	类型	描述
workspace_id	string	工作空间ID
id	string	沙盒 ID
name	string	名称
description	string	描述，若未输入描述，则不会返回该字段
snapshot	object	快照信息
state	string	状态：STATE_RUNNING / STATE_FAILED
volumes	array[object]	挂载的存储,若未挂载存储，则不返回该字段
environment	object	环境变量（键值对），若未设置环境变量，则不返回该字段
creator	string	创建者
updator	string	更新者
cluster_id	string	预留字段，目前返回为
create_time	string	创建时间
update_time	string	更新时间
auto_delete_after	integer	自动删除时长，单位为秒，即从沙盒创建，存活设定时长后系统自动删除该沙盒，若为不自动删除，则不返回该字段
auto_delete_at	string	自动删除时间戳，若为不自动删除，则不返回该字段

其中，snapshot的参数如下：

名称	类型	描述
workspace_id	string	工作空间ID
id	string	快照ID
name	string	快照名称
description	string	快照描述，若快照描述为空，则不返回该字段
image	object	快照所用镜像信息
resource_limits	object	资源规格设置
command	string	启动命令，若为空，则不返回该字段

其中，image的参数如下：

名称	类型	描述
id	string	镜像ID
name	string	镜像名称
type	string	镜像类型, IMAGE_TYPE_BUILT_IN为预置镜像
description	string	镜像描述，若为空，则不返回该字段
repository	string	镜像仓库地址
create_time	string	镜像创建时间
update_time	string	镜像更新时间

其中，resource_limits的参数如下：

名称	类型	描述
cpu	integer	cpu核数，最小为1核
memory	integer	内存规格，单位GiB，最小为1GiB
storage	integer	存储规格，单位GiB，最小为1GiB

其中,volumes每个元素参数如下：

名称	类型	描述
type	string	卷类型，值可能为 VOLUME_TYPE_AFS（挂载文件存储）, VOLUME_TYPE_AOSS（挂载对象存储）
afs	object	afs文件存储卷信息，当type为VOLUME_TYPE_AFS时不为空
aoss	object	aoss存储桶信息，当type为VOLUME_TYPE_AOSS时不为空

其中,afs每个元素参数如下：

名称	类型	描述
volume_id	string	卷ID
source_path	string	NFS 源路径（主机端路径）
target_path	string	容器内挂载路径（目标路径）

其中，aoss每个元素参数如下：

名称	类型	描述
bucket	string	存储桶名称
endpoint	string	桶的Endpoint
access_key	string	密钥ID
target_path	string	沙盒内挂载路径
mount_options	string	挂载高级配置参数，若为空，则不会返回该字段

响应示例（Response Example）

• 正常响应

{
    "workspace_id": "01995733-e3da-7635-99ae-f1acf14364c4",
    "id": "bc810268-bfe4-4188-a8ed-e7999f34cb55",
    "name": "pxtest",
    "snapshot": {
        "workspace_id": "01995733-e3da-7635-99ae-f1acf14364c4",
        "id": "18494045-1b93-4054-b072-d9f8055c32ce",
        "name": "最小规格的快照使用",
        "image": {
            "id": "built_in_image_1",
            "name": "registry.sensetime.com/sensecore-higgs/sandbox/bs/code-sandbox:server-20250609",
            "type": "IMAGE_TYPE_BUILT_IN",
            "create_time": "2025-09-16T09:44:11.338666Z",
            "update_time": "2025-09-16T09:44:11.338666Z"
        },
        "resource_limits": {
            "cpu": 1,
            "memory": 1,
            "storage": 1
        },
        "creator": "0629ad1a-3784-4754-af90-948032f41322",
        "create_time": "2025-09-17T10:46:09.853461Z",
        "update_time": "2025-09-17T10:46:09.853461Z"
    },
    "state": "STATE_RUNNING",
    "environment": {
        "test": "ww2"
    },
    "creator": "155809ab-45da-4917-8afc-22a780a3e696",
    "updator": "155809ab-45da-4917-8afc-22a780a3e696",
    "create_time": "2025-11-13T09:07:13.394678095Z",
    "update_time": "2025-11-13T09:07:13.394678095Z",
    "auto_delete_at": "2025-11-14T09:07:13.394677314Z"
}