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.