gpu.aiDocs
CH·02CLI reference

gpu video

Generate and manage videos

Generate and manage videos

Synopsis

Generate a video from a text prompt with a serverless model. Generation runs asynchronously — create returns a queued job immediately (use --wait to poll to completion), get / list track its status and progress, download fetches the finished mp4, and cancel stops an in-flight job. Completed videos are retained for a limited window before they expire.

Billing is per second of output video at the model's catalog rate; the final charge appears as a Cost line (cost_cents in JSON) once the job completes. Failed and cancelled jobs are never billed.

gpu video [command]

Examples

# Submit a job and return the queued video immediately
gpu video create --model gpuai/wan-2.2-t2v --prompt "a timelapse of clouds over mountains"

# Block until the video is ready (poll up to 10 minutes), then download it
gpu video create --model gpuai/wan-2.2-t2v --prompt "ocean waves at sunset" --wait 10m
gpu video download <video-id> --out waves.mp4

# Track progress and list recent jobs
gpu video get <video-id>
gpu video list

# Cancel an in-flight job
gpu video cancel <video-id>

Options

  -h, --help   help for video

Options inherited from parent commands

      --api-base string   API base URL (override with GPUAI_API_BASE env) (default "https://api.gpu.ai/v1")
      --debug             Enable debug logging to stderr
  -o, --output string     Output format: table|json (default table on TTY, json otherwise)

SEE ALSO

← The gpu CLI