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
- deeprelay video - Generate and manage videos