relay-video-gen

$npx mdskill add aAAaqwq/AGI-Super-Team/relay-video-gen

Generate short marketing videos from text prompts with automatic model fallback.

  • Creates 4-8 second video clips from text descriptions for social media.
  • Integrates Google Gemini Veo 3.1 and Xingjiabi video generation APIs.
  • Automatically switches providers when the primary model fails.
  • Delivers ready-to-download MP4 files via async polling workflow.

SKILL.md

.github/skills/relay-video-genView on GitHub ↗
---
name: relay-video-gen
description: Multi-provider video generation with async polling and automatic model fallback
  Generate short videos via relay with provider priority fallback.
  Google Gemini Veo 3.1 (primary, direct API) → Xingjiabi (kling-video fallback).
  Async task-based: submit → poll → download. 4-8 second clips.
  Use when: creating video clips, marketing videos, animated content from text.
  Extensible: add providers by editing RELAY_PRIORITY in the script.
author: Daniel Li
---

# 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.

More from aAAaqwq/AGI-Super-Team

SkillDescription
a-fund-monitor监控 A 股基金实时估值与盘后净值，自动判断交易日并生成提醒或分析。
add-leadAdd company/person/relationship to CRM
ads-agentAI-агент для управления Facebook рекламой. Вызывай для анализа, оптимизации, создания кампаний и отчётов.
afrexai-compliance-auditRun internal compliance audits against major governance and security
afrexai-personal-financeComplete personal finance system — budgeting, debt payoff, investing, tax optimization, net worth tracking, and financial independence planning. Use when managing money, building wealth, paying off debt, planning retirement, or optimizing taxes. Zero dependencies.
after-salesUse when managing post-purchase experience, building customer loyalty, or increasing repeat purchases
agent-contactsAI agent contacts — add, list, remove MCP contacts. Use when someone gives an agent URL, or when you need to view/remove contacts.
agent-model-switcher批量查看和切换子 agent 的模型配置，用于统一调整多 agent 的 provider/model 设置。
agent-patternsFormat SPAWN REQUEST messages to launch parallel agents, generate structured agent status reports, and define communication protocols within the sprint system. Use when the user needs to coordinate multiple agents, format spawn requests, produce agent reports, or establish inter-agent communication patterns.
agent-task-confirmUse when confirming whether a dispatched agent task was actually received, activated, and progressing after sessions_send or other task handoff actions.