# Relay Video Gen

> Relay Video Generation

- Skill: `aaaaqwq/relay-video-gen` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add aaaaqwq/relay-video-gen`
- Raw SKILL.md: https://api.skillmd.com/api/skills/aaaaqwq/relay-video-gen/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: aAAaqwq (https://skillmd.com/u/aaaaqwq)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/aaaaqwq/relay-video-gen

---


# Relay Video Generation

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

## Quick Start

```bash
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

```bash
# 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

1. Submit generation request → get `task_id`
2. Poll every 5s until `completed` / `failed` (max 10 min)
3. Download video to output path
4. 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](references/providers.md) for API formats, model status, and how to add providers.