Automation

SeaCloud CLI provides stable output formats, dry-run support, and task lookup 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, or create generation tasks. 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"}]'

JSON output

The following commands support using --output json to obtain machine-readable results: models list, models spec, run, task status.

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

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