Skip to main content
开始使用

快速开始

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

前置准备

步骤 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"
创建实例并执行： 
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"))
api_key 是 E2B SDK 的必填参数，只需满足 e2b_ 后跟十六进制字符的格式即可，推荐填写 e2b_${ALIYUN_UID}。百炼侧的真实鉴权使用 Authorization: Bearer <百炼 API Key>，不使用 api_key。

下一步

模版管理

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

实例管理与使用

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

Sandbox API

兼容 E2B 协议的 REST API
开始使用
操作指南
更新日志