Openrouter Text2video

openrouter-text2video

Text → video via OpenRouter. Default model: bytedance/seedance-2.0.

Uses the async video-generation endpoint: submit job → poll → download.

Usage

Resolve TOOL_DIR = the directory containing this SKILL.md. Commands below use TOOL_DIR as a symbolic placeholder; replace it with the resolved, quoted path before running Bash.

export OPENROUTER_API_KEY=sk-or-v1-...

python3 TOOL_DIR/scripts/generate_video.py \
  --prompt "A slow dolly push through a retro-futuristic arcade, neon signs reflecting in a puddle" \
  --duration 5 \
  --aspect-ratio 16:9 \
  --resolution 720p \
  --download PROJECT_DIR/assets/hero.mp4

Flags

| Flag | Default | Description | |---|---|---| | --prompt | required | Text prompt | | --download | required | Output MP4 path | | --model | bytedance/seedance-2.0 | Any OpenRouter video model | | --duration | 5 | Seconds | | --aspect-ratio | 16:9 | 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 9:21 | | --resolution | 720p | Model-dependent (e.g. 480p, 720p, 1080p) | | --generate-audio | off | Generate audio with video (if model supports) | | --poll-interval | 5 | Seconds between polls | | --max-wait | 600 | Max total wait time |

Flow

1. POST /api/v1/videos → returns {id, polling_url, status: "pending"}
2. GET /api/v1/videos/{id} every 5s until status == "completed"
3. GET /api/v1/videos/{id}/content → raw MP4 bytes

Pricing

Seedance 2.0: ~$7/M tokens with (height × width × duration × 24) / 1024 token formula. A 5-second 720p 16:9 clip ≈ 145k tokens ≈ $1.

Notes

• Supports text-to-video, image-to-video (first/last frame control via frame_images), and reference-to-video.
• This script only wires text-to-video. Extend the body to add frame_images or input_references for advanced modes.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: QinghongLin
• Source: QinghongLin/data2story-skill
• License: MIT
• Homepage: https://data2story.github.io/

Install and usage instructions live in the source repository linked above.