自动化

SeaCloud CLI 提供稳定的输出格式、模拟运行、任务查询和沙箱生命周期命令，便于在 Agent、CI 和脚本中使用。

任务状态

run 命令会自动等待任务结果。需要单独查询任务时，可根据任务 ID 使用 task status 命令，任务 ID 可从 seacloud run 的响应字段中获取。

seacloud task status <task_id>
seacloud task status <task_id> --output url
seacloud task status <task_id> --output json

模拟运行

使用 --dry-run 可以在真正执行前预览请求、参数和目标动作。该模式不会发送网络请求，不会写入凭证，不会安装技能，不会创建生成任务，也不会变更沙箱资源，适合在脚本或 Agent 自动执行前检查命令。

seacloud --dry-run run seedance_2_0 --param content='[{"type":"text","text":"test"}]'
seacloud --dry-run sandbox kill --all --state running,paused --metadata app=agent
seacloud --dry-run sandbox network update <sandbox_id> --allow-internet-access=false

JSON 输出

以下命令支持使用 --output json 获取机器可读结果：models list、models spec、run、task status，以及 create、list、logs、metrics 等沙箱命令。sandbox/template 命令也支持 --format json，用于兼容 E2B 风格的自动化脚本。

seacloud models list --output json
seacloud models spec seedance_2_0 --output json
seacloud run seedance_2_0 --param content='[{"type":"text","text":"test"}]' --output json
seacloud sandbox create base --no-connect --wait --output json --metadata app=agent
seacloud sandbox logs <sandbox_id> --limit 100 --direction backward --output json
seacloud template list --format json

沙箱自动化

Agent 或 CI 创建沙箱时，使用 --no-connect 和 --output json。保存返回的 sandbox ID，并显式清理。

seacloud auth status
seacloud sandbox create base --no-connect --wait --output json --metadata app=agent
seacloud sandbox exec <sandbox_id> "python --version"
seacloud sandbox logs <sandbox_id> --limit 100 --direction backward --output json
seacloud sandbox metrics <sandbox_id> --output json
seacloud --dry-run sandbox kill <sandbox_id>
seacloud sandbox kill <sandbox_id>

批量清理前先预览筛选条件，并保持筛选条件足够窄：

seacloud --dry-run sandbox kill --all --state running,paused --metadata app=agent
seacloud sandbox kill --all --state running,paused --metadata app=agent

环境配置

通过环境变量配置 CLI 使用的服务地址。

变量	说明
`SEACLOUD_MODELS_URL`	覆盖模型列表和模型规格服务地址
`SEACLOUD_GENERATION_URL`	覆盖任务状态查询使用的生成服务地址
`SEACLOUD_SKILLHUB_URL`	覆盖 SkillHub API 地址
`SEACLOUD_BASE_URL`	覆盖 SeaCloud API 主地址；sandbox 命令会归一化到 `/api/sandbox/v1`
`SEACLOUD_SANDBOX_URL`	直接覆盖 sandbox API base URL
`SEACLOUD_NAMESPACE_ID`	发送 sandbox namespace 作用域 Header
`SEACLOUD_USER_ID`	发送 sandbox user 作用域 Header
`SEACLOUD_PROJECT_ID`	发送 sandbox project 或 team 作用域 Header