Automation

SeaCloud CLI provides stable output formats, dry-run support, task lookup, and sandbox lifecycle commands for agents, CI, and scripts.

Task status

The run command automatically waits for the task result. If you need to query a task separately, use the task status command with the task ID. The task ID can be obtained from the response fields of seacloud run.

Tip

When using —output json, the task ID can be obtained from the id field in the response.

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

Global dry run

Use --dry-run to preview the request, parameters, and target actions before actual execution. This mode does not send network requests, write credentials, install skills, create generation tasks, or mutate sandbox resources. It is suitable for checking commands before automated execution in scripts or agents.

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

The following commands support using --output json to obtain machine-readable results: models list, models spec, run, task status, and sandbox commands such as create, list, logs, and metrics. Sandbox and template commands also accept --format json for E2B-compatible automation.

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

Sandbox automation

Use --no-connect and --output json when an agent or CI job creates a sandbox. Store the returned sandbox ID and clean it up explicitly.

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>

For bulk cleanup, preview filters first and keep filters narrow:

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

Configuration

Configure CLI service URLs through environment variables.

Variable	Description
SEACLOUD_MODELS_URL	Overrides the model list and model specification service URL
SEACLOUD_GENERATION_URL	Overrides the generation service URL used for task status lookup
SEACLOUD_SKILLHUB_URL	Overrides the SkillHub API URL
SEACLOUD_BASE_URL	Overrides the SeaCloud API origin; sandbox commands normalize it to /api/sandbox/v1
SEACLOUD_SANDBOX_URL	Overrides the sandbox API base URL directly
SEACLOUD_NAMESPACE_ID	Sends a sandbox namespace scope header
SEACLOUD_USER_ID	Sends a sandbox user scope header
SEACLOUD_PROJECT_ID	Sends a sandbox project or team scope header