前提条件

• 在控制台完成沙箱模板创建。

• 在执行下文所有代码前，请先按照环境变量设置部分，完成环境变量设置。

创建沙箱实例

from e2b_code_interpreter import Sandbox
from dotenv import load_dotenv

load_dotenv()

# 注意：修改下面模板为您的模板名称或者模板id
sandbox = Sandbox.create(template="my_test_code_template")

# 您可以在创建时指定超时时间
# 当沙箱的运行时间超过超时时间时，沙箱将会被自动删除
sandbox2 = Sandbox.create(
    template="my_test_code_template",
    timeout=300 # 单位为秒
)

获取沙箱实例列表

您可以使用 Sandbox.list() 获取到分页器，并使用分页器来以页为单位获取具体的沙箱实例信息。

from e2b_code_interpreter import Sandbox
from dotenv import load_dotenv

load_dotenv()

# 调用list方法获取分页器
paginator = Sandbox.list()

# 若分页器还有下一页，则取出下一页
while paginator.has_next:
    page = paginator.next_items()
    # 打印当前取出页的沙箱实例信息
    for sandbox_info in page:
        print(sandbox_info)

# 您可以指定一页中有多少实例
paginator_limit_5 = Sandbox.list(limit=5)

获取沙箱实例信息

您可以通过使用 get_info 方法来获取沙箱信息。

from e2b_code_interpreter import Sandbox
from dotenv import load_dotenv

load_dotenv()

# 注意：修改下面模板为您的模板名称或者模板id
sandbox = Sandbox.create(template="my_test_code_template")

# 获取沙箱实例信息
info = sandbox.get_info()
print(info)

# 输出结果示例
# SandboxInfo(
# sandbox_id='ieox0wgidbfmdjw53lba5',
# sandbox_domain='',
# template_id='2e55502a-9171-4672-af89-bdb1a569384a',
# name='my_test_code_template',
# metadata={},
# started_at=datetime.datetime(2026, 4, 23, 20, 52, 57, 189652, tzinfo=tzoffset(None, 28800)),
# end_at=datetime.datetime(2026, 4, 23, 20, 57, 57, 189652, tzinfo=tzoffset(None, 28800)),
# state=<SandboxState.RUNNING: 'running'>,
# envd_version='0.2.4',
# _envd_access_token='a04943bc878fb5cd5d3fc919a8645cd32ecdc8665969f5da60dd21126eb1a8ad'
# )

删除沙箱实例

from e2b_code_interpreter import Sandbox
from dotenv import load_dotenv

load_dotenv()

# 注意：修改下面模板为您的模板名称或者模板id
sandbox = Sandbox.create(template="my_test_code_template")

# 删除沙箱实例
sandbox.kill()