跳转到主要内容
千问AI平台 home page
文档
开始使用

快速开始

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

前置准备

步骤 1：创建模版

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

步骤 2：获取 API Key

调用沙箱需使用千问AI平台 API Key 进行鉴权。在 Sandbox 页左下角点击 API-KEY，创建或复制一个 API Key（格式 sk-...）。

步骤 3：发起首次调用

Sandbox 兼容 E2B SDK。安装 SDK 后，使用千问AI平台沙箱接入地址与 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
DASHSCOPE_API_KEY = "sk-..."            # 千问AI平台 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 {DASHSCOPE_API_KEY}"},  # 千问AI平台 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}。千问AI平台侧的真实鉴权使用 Authorization: Bearer <千问AI平台 API Key>，不使用 api_key。

下一步

模版管理

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

实例管理与使用

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

Sandbox API

兼容 E2B 协议的 REST API