Command Reference

Quickly inspect commands and arguments by command group.

auth

seacloud auth login
seacloud auth status
seacloud auth set-key <api-key>
seacloud auth logout

skills

seacloud skills list [--category <category>] [--sort stars|downloads|updated] [--output json]
seacloud skills find [query] [--category <category>] [--cursor <cursor>] [--output json]
seacloud skills add <slug> [--version <version>] [--global] [--yes]
seacloud skills config --show
seacloud skills config --set-url <url>

run

seacloud run <model_id> --param key=value [--output url|json] [--timeout <seconds>]

models

seacloud models list [--type video|image|audio] [--keywords <keyword>] [--page <n>] [--page-size <n>] [--output id|json]
seacloud models spec <model_id> [--output json]

task

seacloud task status <task_id> [--output url|json]

sandbox

Sandbox commands use your SeaCloud login session. Run seacloud auth login first. Set SEACLOUD_SANDBOX_URL or SEACLOUD_BASE_URL only when you need to target a non-default sandbox API root.

seacloud sandbox create [template] [--timeout <seconds>] [--wait] [--no-connect] [--output json]
seacloud sandbox list [--state running,paused] [--metadata key=value] [--limit <n>] [--next-token <token>]
seacloud sandbox info <sandbox_id>
seacloud sandbox exec <sandbox_id> <command...> [--cwd <path>] [--env key=value] [--timeout-ms <ms>]
seacloud sandbox exec --background <sandbox_id> <command...>
seacloud sandbox connect <sandbox_id> [--shell sh|bash] [--timeout <seconds>]
seacloud sandbox logs <sandbox_id> [--limit <n>] [--cursor <cursor>] [--direction forward|backward] [--level <level>] [--search <text>]
seacloud sandbox metrics [sandbox_id...] [--limit <n>] [--output json]
seacloud sandbox pause <sandbox_id>
seacloud sandbox timeout <sandbox_id> --seconds <seconds>
seacloud sandbox refresh <sandbox_id> [--duration <seconds>]
seacloud sandbox kill <sandbox_id...>
seacloud sandbox kill --all [--state running,paused] [--metadata key=value]

Network, volume, event, webhook, and team helpers:

seacloud sandbox network update <sandbox_id> [--allow-public-traffic true|false] [--allow-internet-access true|false] [--allow-out <cidr>] [--deny-out <cidr>]
seacloud sandbox volume create <name>
seacloud sandbox volume list
seacloud sandbox volume get <volume_id>
seacloud sandbox volume delete <volume_id>
seacloud sandbox events [sandbox_id] [--type <event>] [--limit <n>] [--offset <n>] [--order-asc]
seacloud sandbox webhook list
seacloud sandbox webhook create --name <name> --url <https-url> --secret <secret> [--event <event>]
seacloud sandbox webhook update <webhook_id> [--enabled true|false]
seacloud sandbox webhook deliveries [--webhook-id <id>] [--event-id <id>] [--status <status>]
seacloud sandbox webhook replay <delivery_id>
seacloud sandbox team list
seacloud sandbox team metrics <team_id> [--start <unix>] [--end <unix>]
seacloud sandbox team metrics-max <team_id> --metric concurrent_sandboxes|sandbox_start_rate [--start <unix>] [--end <unix>]

template

seacloud template list [--visibility <scope>] [--limit <n>] [--offset <n>] [--format json]
seacloud template get <template>
seacloud template exists <template>

version

seacloud version