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.
700+ AI models (Google, OpenAI, ByteDance, Kling, Luma) via one API. Images in <2s, videos in <2min.
WAVESPEED_API_KEY env var — already set in all Clawster containers, just use it directlyTOOLS.md in the workspace — look for WaveSpeed AI sectionNever search for the key — if WAVESPEED_API_KEY is in the environment, it's ready to go. Check with:
echo $WAVESPEED_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.
# 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
| 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.
nbp, nb-edit): always pass images as images: [url] array — this is requiredgoogle/nano-banana-pro/edit is the best model for editing photos while keeping the person's face identical--output to specify path--images url1,url2