Skip to main content

快速开始

通过控制台完成服务授权、创建模版、生成 API Key 并发起首次调用，几分钟内启动第一个沙箱。

沙箱完成路径

1. 完成服务授权

确认 SLR 与数据访问协议。

2. 创建模版

选择镜像、资源与生命周期。

3. 获取 API Key

准备目标工作空间的鉴权凭证。

4. 执行并读回文件

创建实例，运行命令并核对文件内容。

前置准备

步骤 1：完成服务授权

首次使用 Sandbox 时，需完成服务关联角色（SLR）授权，以便阿里云百炼创建与管理沙箱运行环境。 进入阿里云百炼控制台 > Sandbox，首次创建模版时弹出“阿里云服务授权”对话框：
字段值
角色名称AliyunServiceRoleForSFMSandbox
角色权限策略AliyunServiceRolePolicyForSFMSandbox
权限说明允许阿里云百炼服务访问沙箱计算与网络资源，完成沙箱实例的创建、运行与释放
勾选《数据访问授权协议》后点击确认授权，即完成一次性授权。

步骤 2：创建模版

模版定义沙箱的运行环境。进入 Sandbox > 我的模版，点击创建模版，配置以下字段：
字段说明
选择镜像三选一：code-interpreter-v1（代码执行）、browser（浏览器操作）、all-in-one（综合能力）
模版名称必填，自定义
资源配置必选。配置 1（1 Core｜2 GB，推荐）或配置 2（4 Core｜8 GB）
如需文件挂载、网络白/黑名单、环境变量或生命周期控制，展开高级配置按需设置。填写完成后点击创建。创建成功后模版出现在列表中，记录其 templateCode 用于后续调用。
生命周期控制中，空闲超时与最大存活时间二选一，最长保持 7 天。

步骤 3：获取 API Key

调用沙箱需使用阿里云百炼 API Key 进行鉴权。在 Sandbox 页左下角点击 API-KEY，创建或复制一个 API Key（格式 sk-...）。

步骤 4：发起首次调用

Sandbox 兼容 E2B SDK。安装 SDK 后，使用阿里云百炼沙箱接入地址与 API Key 创建实例并执行代码。 安装 SDK： 
pip install "e2b==2.31.0"
# 如需 run_code 等 Code Interpreter 能力
pip install "e2b-code-interpreter==2.8.1"
创建实例前，替换下方示例中的输入：
  • {workspace_id}：按 Sandbox API 前提条件在控制台右上角查看实际工作空间 ID；也可参考获取业务空间 ID。API Key 与模版应属于此工作空间。
  • ALIYUN_UID：登录阿里云官网，在右上角头像菜单查看账号 ID，将 your aliyunUid 替换为该 UID。
  • BAILIAN_API_KEY：替换为步骤 3 获取的实际 API Key。
  • template：将 你的模版 code 替换为步骤 2 记录的 templateCode。运行此例可选择 code-interpreter-v1 镜像。
api_key 是 E2B SDK 的必填参数，只需满足 e2b_ 后跟十六进制字符的格式即可，推荐填写 e2b_${ALIYUN_UID}。阿里云百炼侧的真实鉴权使用 Authorization: Bearer <阿里云百炼 API Key>，不使用 api_key。
创建实例并执行： 
from e2b import Sandbox

ALIYUN_UID = "your aliyunUid"       # 阿里云 UID
BAILIAN_API_KEY = "sk-..."            # 阿里云百炼 API Key

sbx = Sandbox.create(
    api_url="https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/agentstudio/sandbox",
    api_key=f"e2b_{ALIYUN_UID}",      # 占位参数，满足 E2B SDK 格式即可
    headers={"Authorization": f"Bearer {BAILIAN_API_KEY}"},  # 阿里云百炼 API Key，用于鉴权
    template="你的模版 code",
)

# 执行命令
result = sbx.commands.run("python --version")
print(result.stdout)

# 写入并读取文件
sbx.files.write("/home/user/workspace/hello.md", "hello bailian")
print(sbx.files.read("/home/user/workspace/hello.md"))
result.stdout 输出沙箱内的 Python 版本；文件读回输出 hello bailian，可用于核对命令执行与文件写入、读取是否完成。Python 版本以所选模版内的实际输出为准。
体验后按实例管理与使用管理实例生命周期与资源释放，结合模版的空闲超时或最大存活时间设置处理不再需要的实例。费用规则见Sandbox 计费。

下一步

管理模版

配置镜像、资源规格与生命周期。

管理与释放实例

查看实例生命周期与数据面操作。

接入 Sandbox API

使用兼容 E2B 协议的 REST API。