Relay Video Generation Skill

Relay Video Generation

Multi-provider video generation with async polling and automatic model fallback.

Quick Start

uv run ~/.openclaw/skills/relay-video-gen/scripts/relay_video_gen.py \
  -p "A rotating blue globe with stars in background" \
  -f "globe.mp4"

Parameters

| Flag | Description | Default | |------|-------------|---------| | -p | Video prompt (English) | Required | | -f | Output filename (.mp4) | Required | | -d | Duration in seconds (3-15) | 5 | | -a | Aspect ratio: 16:9, 9:16, 1:1 | 16:9 | | -m | Override model name | kling-video | | -P | Force provider | xingjiabi |

Examples

# 10-second vertical video for Reels/TikTok
uv run ~/.openclaw/skills/relay-video-gen/scripts/relay_video_gen.py \
  -p "A person typing on laptop in coffee shop, warm lighting" \
  -f "coffee.mp4" -d 10 -a 9:16

# Use veo3.1 model
uv run ~/.openclaw/skills/relay-video-gen/scripts/relay_video_gen.py \
  -p "Ocean waves crashing on beach at sunset" \
  -f "ocean.mp4" -m veo3.1-fast

Workflow

Submit generation request → get task_id
Poll every 5s until completed / failed (max 10 min)
Download video to output path
If model fails/saturated → auto-try next model

Model Fallback Order

Gemini (veo-3.1-generate-preview, direct Google API) → xingjiabi: kling-video → veo-3.1-fast → veo-3.1 → minimax/video-01 → grok-video-3

Provider Details

See references/providers.md for API formats, model status, and how to add providers.

Agent Skills: Relay Video Generation

Install this agent skill to your local

Skill Files