TenkajinKB/00_System/Codex/skills/openrouter-seedance/SKILL.md

name, description

name	description
openrouter-seedance	Submit and manage Seedance 2.0 video generation jobs through OpenRouter for local X projects. Use when a user asks Codex to call OpenRouter, generate Seedance/Seedance 2.0 videos, run an X-series prompt through the Seedance model, check Seedance model support/credits, or download generated video output.

OpenRouter Seedance

Overview

Use OpenRouter's async video API to submit Seedance 2.0 text-to-video, image-to-video, first/last-frame, and reference-to-video jobs from this repository. This skill is the execution layer; use the existing seedance-prompt, seedance-storyboard, seedance-review, and prompt-standard-check skills to prepare or audit prompts first.

Required Setup

Never store OpenRouter keys in project files. Read the key from the current shell only:

$env:OPENROUTER_API_KEY='sk-or-v1-...'

If the user provides a key in chat, use it only for the current command environment. Do not write it into SKILL.md, scripts, config, markdown notes, or git-tracked examples.

Workflow

1. For X-series projects, read 00_System/Codex/memory/PROJECT_MEMORY.md before prompt work.
2. If the request includes prompt writing or prompt modification, apply prompt-standard-check and the relevant Seedance prompt/storyboard/review skill first.
3. Run a dry-run payload validation before any paid generation:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --prompt "中文视频提示词" --duration 5 --resolution 720p --aspect-ratio 16:9

4. Submit only when the user clearly wants an actual paid generation job, or when they have already agreed to spend credits:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --prompt "中文视频提示词" --duration 5 --resolution 720p --aspect-ratio 16:9 --submit --wait --output output/seedance/<name>.mp4

5. Report the job id, saved video path, and usage cost if the API returns usage.

Model Choices

• Default high-quality model: bytedance/seedance-2.0.
• Fast/cheap preview model: add --fast to use bytedance/seedance-2.0-fast.
• Supported durations for Seedance 2.0 are 4-15 seconds.
• Supported aspect ratios include 1:1, 3:4, 9:16, 4:3, 16:9, 21:9, and 9:21.
• bytedance/seedance-2.0-fast supports only 480p and 720p; full bytedance/seedance-2.0 supports 480p, 720p, 1080p, and 4K.

Common Commands

Check credits:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --credits

List available Seedance video models:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --models

Preview a low-cost request without spending credits:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --fast --prompt "雨后竹林中，一位白发少女缓慢转头，暖黄柔光穿过薄雾，镜头缓慢推进，治愈日系动画质感，无文字无字幕" --duration 4 --resolution 480p --aspect-ratio 16:9

Submit and download:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --fast --prompt "雨后竹林中，一位白发少女缓慢转头，暖黄柔光穿过薄雾，镜头缓慢推进，治愈日系动画质感，无文字无字幕" --duration 4 --resolution 480p --aspect-ratio 16:9 --submit --wait --output output/seedance/test.mp4

Use an image URL as first frame:

python 00_System/Codex/skills/openrouter-seedance/scripts/openrouter_seedance.py --prompt "保持首帧角色外观，少女轻轻转头，固定机位，暖黄柔光，治愈氛围，无文字无字幕" --first-frame "https://example.com/first.png" --duration 5 --resolution 720p --aspect-ratio 9:16

Safety Rules

• Default to dry-run unless the user asks to generate, submit, run, or otherwise spend credits.
• Use 480p or 720p for tests; reserve 1080p/4K for approved final renders.
• Keep video prompt text Chinese-first for Seedance.
• Include no-text constraints for X projects unless the user explicitly wants readable text.
• Avoid uploading real-person face references. If the user gives IP or character names, follow project memory and prompt skills for compliant descriptive rewriting.
• Save generated files under output/seedance/ or the relevant X project output folder when one exists.

Script

Use scripts/openrouter_seedance.py. It delegates to the verified repository tool at tools/openrouter_seedance.py, so command options stay consistent across direct tool use and skill use.