KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #developer-tools #ai-agent #claude-code #codex #typescript #ai-agents #deepseek-harness #mcp #cli #rust

seedance-video-skills

★ 1 Open GitHub ↗

ByteDance Seedance 2.0 video generation skills for Claude Code — kie.ai primary (face refs OK), Runware automatic backup

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Seedance Video Skills

![cover](https://raw.githubusercontent.com/guyaga/seedance-video-skills/main/assets/cover.png)

**ByteDance Seedance 2.0 video generation for [Claude Code](https://claude.com/claude-code).**
kie.ai as the primary backend (the only one that accepts photoreal human face references), Runware as automatic backup, plus a cinema-grade prompt engineering skill.

## How to install (humans, read this part only)

Open Claude Code and paste this:

> Install the Seedance video skills from https://github.com/guyaga/seedance-video-skills — clone it and follow the "Instructions for Claude" section in its README.

That's it. Claude will clone the repo, install both skills, ask you for your API keys, and verify everything works. You'll need:

- A **kie.ai** API key (primary) — sign up at [kie.ai](https://kie.ai), top up a few dollars of credits, copy the key from the API Keys page.
- A **Runware** API key (backup, optional but recommended) — sign up at [runware.ai](https://runware.ai), add credits, copy the key from the dashboard.
- **Python 3.10+** on your machine (no packages to install — the scripts use only the standard library).

After install, just tell Claude things like *"make a Seedance video of a fox running through neon Tokyo, 9:16, 8 seconds"*.

## What's inside

| Skill | What it does |
|-------|--------------|
| `seedance-make-video` | Turns a prompt (+ optional reference images / first & last frames) into a finished MP4. Routes to **kie.ai first**, falls back to **Runware** automatically if kie fails. Face references always go through kie.ai (`nsfw_checker=false` bypasses ByteDance's input-image face filter — Runware's raw model rejects photoreal faces). |
| `seedance-2-prompt-engineer` | Writes cinema-grade Seedance 2.0 prompts: timestamped storyboards, `@image`/`@video`/`@audio` multimodal references, segmented extension for >15s videos, bilingual EN+ZH output for the Jimeng UI, and a storyboard-sheet workflow. |

Typical flow: ask for a video → the prompt engineer writes the prompt → make-video renders it and downloads the MP4 to `~/Seedance Videos/`.

## Pricing ballpark

- **kie.ai**: ~205 credits per 720p / 5s clip (roughly $0.20 — check current rates).
- **Runware**: $0.06–0.16/s at 480p–720p (`fast`/`full`), up to $0.40/s at 1080p.

The skills always show you a cost estimate before submitting anything.

---

## Instructions for Claude

You (Claude) are installing this skill bundle for the user. Follow these steps exactly.

### 1. Get the files

If you haven't already cloned this repo:

```bash
git clone https://github.com/guyaga/seedance-video-skills
```

### 2. Install the skills

Copy both skill folders into the user's global skills directory (`~/.claude/skills/`):

```bash
# macOS / Linux (bash)
mkdir -p ~/.claude/skills
cp -r seedance-video-skills/skills/seedance-make-video ~/.claude/skills/
cp -r seedance-video-skills/skills/seedance-2-prompt-engineer ~/.claude/skills/
```

```powershell
# Windows (PowerShell)
New-Item -ItemType Directory -Force "$env:USERPROFILE\.claude\skills"
Copy-Item -Recurse -Force seedance-video-skills\skills\seedance-make-video "$env:USERPROFILE\.claude\skills\"
Copy-Item -Recurse -Force seedance-video-skills\skills\seedance-2-prompt-engineer "$env:USERPROFILE\.claude\skills\"
```

(Alternative: this repo is also a Claude Code plugin marketplace — `/plugin marketplace add guyaga/seedance-video-skills` then `/plugin install seedance-video@seedance-video-skills`. Prefer the copy method above unless the user asks for the plugin route.)

### 3. Check Python

Run `python --version` (or `python3 --version`). Anything 3.10+ is fine. If missing, help the user install it before continuing.

### 4. Ask the user for their API keys

Ask for both keys (kie.ai is required; Runware is the optional backup):

- kie.ai key → from https://kie.ai (API Keys page; they need credits topped up)
- Runware key → from https://my.runware.ai (API keys section)

**Never commit these keys anywhere.** Persist them as environment variables:

```powershell
# Windows — persists to user environment; restart the terminal afterwards
setx KIE_API_KEY "their-kie-key"
setx RUNWARE_API_KEY "their-runware-key"
```

```bash
# macOS / Linux — append to the user's shell profile (~/.zshrc or ~/.bashrc)
echo 'export KIE_API_KEY="their-kie-key"' >> ~/.zshrc
echo 'export RUNWARE_API_KEY="their-runware-key"' >> ~/.zshrc
```

### 5. Verify

Run a dry-run (no charge, no network submission) from the installed skill folder:

```bash
python ~/.claude/skills/seedance-make-video/bin/make_video.py "test prompt" --dry-run --duration 5
```

It should print a JSON request body. If the user set keys in this session, a fresh terminal may be needed for `setx`/profile changes to take effect — tell them that.

### 6. Confirm and demo

Tell the user the skills are installed and offer a first video, e.g.:

> "Installed. Want to try one? For example: *make a Seedance video of a golden retriever surfing a wave at sunset, 16:9, 5 seconds* (~$0.20)."

New Claude Code sessions will pick up the skills automatically.

---

## Notes & gotchas

- **ByteDance's face filter is real**: Seedance 2.0 rejects input images containing photoreal human faces at the platform level (even AI-generated portraits or eye-censored photos). Runware exposes the model raw, so face refs fail there. kie.ai's `nsfw_checker: false` input flag is the working bypass — which is why it's the primary backend and the *only* route for `--face-ref`.
- Duration is an integer 4–15 seconds. 1080p requires Runware `--model full`.
- Videos + JSON sidecars land in `~/Seedance Videos/<project>/`.
- kie.ai sits behind Cloudflare; the bundled script sends a browser User-Agent so requests pass.

## License

MIT © Guy Aga

seedance-video-skills

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README