How do I install the Wavespeed skill?

Run npx skillmds@latest add johnalbertini14-glitch/wavespeed in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Wavespeed safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Wavespeed?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Wavespeed free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Wavespeed?

johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Wavespeed by johnalbertini14-glitch

Name: Wavespeed
Rating: 4.666666666666667 (3 reviews)
Author: johnalbertini14-glitch

Wavespeed

Generate and edit images and videos using WaveSpeed AI's 700+ model library. Use when the user wants to generate images from text prompts (FLUX, Seedream, Qwen), edit or retouch photos (nano-banana-pro/edit keeps faces identical while changing clothes/background), generate videos from images or text (Kling, Veo, Sora, Wan, Hailuo), or upscale videos to 4K. Triggers include: generate an image, edit this photo, change the background, swap the outfit, make a video from this image, animate this photo, upscale this video, use WaveSpeed, use nano banana pro.

File contents

WaveSpeed AI

700+ AI models (Google, OpenAI, ByteDance, Kling, Luma) via one API. Images in <2s, videos in <2min.

API Key — check in this order

WAVESPEED_API_KEY env var — already set in all Clawster containers, just use it directly
TOOLS.md in the workspace — look for WaveSpeed AI section
Ask the user

Never search for the key — if WAVESPEED_API_KEY is in the environment, it's ready to go. Check with:

echo $WAVESPEED_API_KEY

Get your API key

Sign up at wavespeed.ai → Dashboard → API Keys.
New accounts get free credits. Pay-as-you-go pricing — no subscription required.

export WAVESPEED_API_KEY=your_key_here

The skill script is at skills/wavespeed/scripts/wavespeed.js.

Usage

# Image generation
node wavespeed.js generate --model flux --prompt "sunset over mountains" --output out.png
node wavespeed.js generate --model seedream --prompt "..." --size 1024x1024

# Image editing (face/portrait-safe — preserves identity)
node wavespeed.js edit --model nbp --prompt "change bathrobe to black hoodie, dark background" \
  --image https://example.com/photo.jpg --output result.png

# Video from image
node wavespeed.js video --model wan-i2v --prompt "slow cinematic zoom" \
  --image https://example.com/frame.jpg --output clip.mp4

# List all aliases
node wavespeed.js models

# Check task status
node wavespeed.js status --id task_abc123

Key Models (Quick Reference)

Task	Alias	Best for
Edit photo keeping face	`nbp`	Portrait retouching, outfit/bg change
Fast image gen	`flux-schnell`	Drafts, quick tests
Best image quality	`flux-pro` / `seedream`	Final outputs
Image → Video	`wan-i2v`	Fast, affordable
Premium video	`kling` / `veo`	Cinematic quality
Text → Video	`sora` / `veo`	Story videos

See references/models.md for full model list with IDs, params, and pricing.

Important Notes

Image editing (nbp, nb-edit): always pass images as images: [url] array — this is required
Face preservation: google/nano-banana-pro/edit is the best model for editing photos while keeping the person's face identical
Output files are saved to current directory by default; use --output to specify path
Videos can take 2-5 minutes; script auto-polls with progress indicator
For multiple input images (multi-reference editing), use --images url1,url2

---name: wavespeeddescription: Generate and edit images and videos using WaveSpeed AI's 700+ model library. Use when the user wants to generate images from text prompts (FLUX, Seedream, Qwen), edit or retouch photos (nano-banana-pro/edit keeps faces identical while changing clothes/background), generate videos from images or text (Kling, Veo, Sora, Wan, Hailuo), or upscale videos to 4K. Triggers include: generate an image, edit this photo, change the background, swap the outfit, make a video from this image, animate this photo, upscale this video, use WaveSpeed, use nano banana pro.---# WaveSpeed AI700+ AI models (Google, OpenAI, ByteDance, Kling, Luma) via one API. Images in <2s, videos in <2min.## API Key — check in this order1. **`WAVESPEED_API_KEY` env var** — already set in all Clawster containers, just use it directly2. `TOOLS.md` in the workspace — look for `WaveSpeed AI` section3. Ask the user**Never search for the key** — if `WAVESPEED_API_KEY` is in the environment, it's ready to go. Check with:```bashecho $WAVESPEED_API_KEY```### Get your API keySign up at **[wavespeed.ai](https://wavespeedai.pxf.io/3kPoRd)** → Dashboard → API Keys. New accounts get free credits. Pay-as-you-go pricing — no subscription required.```bashexport WAVESPEED_API_KEY=your_key_here```The skill script is at `skills/wavespeed/scripts/wavespeed.js`.## Usage```bash# Image generationnode wavespeed.js generate --model flux --prompt "sunset over mountains" --output out.pngnode wavespeed.js generate --model seedream --prompt "..." --size 1024x1024# Image editing (face/portrait-safe — preserves identity)node wavespeed.js edit --model nbp --prompt "change bathrobe to black hoodie, dark background" \ --image https://example.com/photo.jpg --output result.png# Video from imagenode wavespeed.js video --model wan-i2v --prompt "slow cinematic zoom" \ --image https://example.com/frame.jpg --output clip.mp4# List all aliasesnode wavespeed.js models# Check task statusnode wavespeed.js status --id task_abc123```## Key Models (Quick Reference)| Task | Alias | Best for ||------|-------|---------|| Edit photo keeping face | `nbp` | Portrait retouching, outfit/bg change || Fast image gen | `flux-schnell` | Drafts, quick tests || Best image quality | `flux-pro` / `seedream` | Final outputs || Image → Video | `wan-i2v` | Fast, affordable || Premium video | `kling` / `veo` | Cinematic quality || Text → Video | `sora` / `veo` | Story videos |See `references/models.md` for full model list with IDs, params, and pricing.## Important Notes- **Image editing** (`nbp`, `nb-edit`): always pass images as `images: [url]` array — this is required- **Face preservation**: `google/nano-banana-pro/edit` is the best model for editing photos while keeping the person's face identical- Output files are saved to current directory by default; use `--output` to specify path- Videos can take 2-5 minutes; script auto-polls with progress indicator- For multiple input images (multi-reference editing), use `--images url1,url2`

Frequently asked questions