CH·02CLI reference

deeprelay video create

Create a video generation job

Create a video generation job

Synopsis

Submits a video generation job. With --wait>0 the CLI polls the job until it reaches a terminal status (completed/failed/expired/cancelled); --wait=0 (the default) returns the queued job immediately so you can track progress with deeprelay video get and fetch it later with deeprelay video download.

Examples

# Submit and return immediately
deeprelay video create --model deeprelay/seedance-1.0-lite --prompt "a timelapse of clouds over mountains"

# Set the clip length (each model declares its bounds + default in
# `deeprelay models get <id>`; omitting --seconds uses the model default)
deeprelay video create --model deeprelay/seedance-1.0-lite --prompt "ocean waves at sunset" \
  --seconds 5

# Block until the job finishes (poll up to 10 minutes)
deeprelay video create --model deeprelay/seedance-1.0-lite --prompt "city traffic at night" --wait 10m
deeprelay video create [flags]

Options

  -h, --help            help for create
      --model string    Video model id (e.g., deeprelay/seedance-1.0-lite) — required
      --prompt string   Text prompt describing the video — required
      --seconds int     Desired video length in seconds
      --size string     Video size as WxH (e.g., 1280x720)
      --wait duration   How long to poll the job for a terminal status; 0 = don't poll, return immediately

Options inherited from parent commands

      --api-base string   API base URL (override with DEEPRELAY_API_BASE env) (default "https://api.deeprelay.ai/v1")
      --debug             Enable debug logging to stderr
      --no-preflight      Skip the plan/credit check before inference requests (override with DEEPRELAY_NO_PREFLIGHT env)
  -o, --output string     Output format: table|json (default table on TTY, json otherwise) (default "table")

SEE ALSO

← The gpu CLI