Skill wavespeed
✓ VérifiéGénérez et éditez des médias propulsés par l'IA, notamment des images, des vidéos, de l'audio et des actifs 3D, via des outils MCP ou une CLI.
- Étoiles GitHub
- 26
- Fichiers
- 1
- Dernier commit
- 10 nov. 2026
- Licence
- MIT
- Outils autorisés
- —
Que fait la skill wavespeed ?
Générez et éditez des médias propulsés par l'IA, notamment des images, des vidéos, de l'audio et des actifs 3D, via des outils MCP ou une CLI.
Résumé généré à partir du SKILL.md de la skill.
À propos du skill wavespeed
La création et la modification de médias générés par l'IA, tels que des images, des vidéos, de l'audio et des actifs 3D, sont possibles grâce à WaveSpeed. Les développeurs peuvent utiliser les outils MCP de WaveSpeed lorsqu'ils sont connectés à un environnement hébergé, ou la CLI wavespeed pour la gestion de fichiers locaux et le traitement par lots. Le système propose des raccourcis spécialisés pour les tâches courantes, comme la génération d'images à partir de prompts, l'édition de vidéos existantes ou l'extension de clips vidéo. Pour des besoins plus spécifiques comme l'upscaling ou la génération de musique, la commande run générique permet d'accéder à n'importe quel modèle du catalogue en direct.
Lors d'un travail via le MCP server hébergé, les utilisateurs doivent fournir des URL publiques car le serveur ne peut pas accéder aux fichiers locaux. À l'inverse, la CLI gère facilement les fichiers locaux grâce à la syntaxe @./path. La plateforme inclut des outils pour estimer les coûts avant de lancer une tâche, vérifier le solde de crédits restants et inspecter les schémas des modèles afin de garantir la conformité des entrées. Les utilisateurs peuvent sélectionner des modèles spécifiques comme seedream-5-pro pour les images ou kling-4.0 pour la vidéo, ou s'appuyer sur les valeurs par défaut fournies par le système.
Ce qu'un agent peut faire avec
- 1Générer des visuels marketingCréez de nouvelles images ou vidéos à partir de prompts textuels pour concevoir du contenu promotionnel.
- 2Modifier des médias existantsÉditez, changez le style ou combinez plusieurs images en une seule composition.
- 3Étendre des séquences vidéoPrenez un clip vidéo existant et générez des images supplémentaires pour l'allonger.
- 4Estimer les coûts de productionCalculez le prix d'une tâche de génération vidéo avant de soumettre la requête.
Rédigé à partir du SKILL.md du skill. Chaque cas d'utilisation est vérifié par rapport à une citation de celui-ci.
Comment installer la skill wavespeed
Chaque commande copie le dossier de la skill dans le répertoire des skills du client. Redémarrez le client ou démarrez une nouvelle session pour la charger.Installer la skill wavespeed dans Claude Code
~/.claude/skills/wavespeed/SKILL.md
$ npx degit WaveSpeedAI/wavespeed-cli/skills ~/.claude/skills/wavespeedInstaller la skill wavespeed dans Claude Code (project)
.claude/skills/wavespeed/SKILL.md
$ npx degit WaveSpeedAI/wavespeed-cli/skills .claude/skills/wavespeedInstaller la skill wavespeed dans Codex
~/.agents/skills/wavespeed/SKILL.md
$ npx degit WaveSpeedAI/wavespeed-cli/skills ~/.agents/skills/wavespeedInstaller la skill wavespeed dans Gemini CLI
~/.gemini/skills/wavespeed/SKILL.md
$ npx degit WaveSpeedAI/wavespeed-cli/skills ~/.gemini/skills/wavespeedInstaller la skill wavespeed dans Claude.ai
npx degit WaveSpeedAI/wavespeed-cli/skills wavespeed && zip -r wavespeed.zip wavespeed # claude.ai → Customize → Skills → + → Create skill → Upload a skill → wavespeed.zip
Vérifications automatisées
Exécuté le 15 nov. 2026Rapport complet →A réussi nos vérifications automatiques. Ce n'est pas un audit de sécurité : lisez les scripts avant de laisser un agent les exécuter. Fonctionnement des vérifications · Ce qu'il faut corriger pour gagner des points
- Dépôt source lié et accessiblewavespeedai/wavespeed-cli/skills is public and reachablegithub.com/wavespeedai/wavespeed-cli/tree/HEAD/skills ↗Réussi
- Licence open source (OSI)MITspdx.org/licenses/MIT.html ↗Réussi
- Commit ou version publiée au cours de l'année écouléeLast commit 2026-11-10github.com/wavespeedai/wavespeed-cli/commits ↗Réussi
- Aucun téléchargement-exécution ni vol d'identifiants dans les scriptsNo scripts in the skill folderRéussi
- Aucune instruction cachée dans SKILL.mdNo override phrases, safeguard switches, credential requests or hidden charactersgithub.com/wavespeedai/wavespeed-cli/blob/HEAD/skills/SKILL. ↗Réussi
- Les outils préautorisés sont limitésNo pre-approved tools; the agent asks before using onegithub.com/wavespeedai/wavespeed-cli/blob/HEAD/skills/SKILL. ↗Réussi
- SKILL.md respecte le format Agent Skillsname "wavespeed" differs from the folder "skills"github.com/wavespeedai/wavespeed-cli/blob/HEAD/skills/SKILL. ↗Faille
SKILL.md
Voir sur GitHubWaveSpeed
WaveSpeed runs every model on its platform. There are two ways in, and they do the same things:
- MCP tools (
generate_image,generate_video, …): use them when the WaveSpeed MCP server is connected. The hosted server cannot read local files: pass public URLs, or use the CLI for files on disk. - The
wavespeedCLI: use it when it is installed, for local files (@./path), batches and scripts.
For plain image and video work, use the shortcuts. For anything else (audio, 3D, upscaling, a specific endpoint, exact parameters), use the generic run.
Images and videos: the shortcuts
| Task | CLI | MCP tool |
|---|---|---|
| Image from a prompt (optionally with reference pictures) | wavespeed generate image "<prompt>" [--image @./ref.jpg] |
generate_image |
| Edit, restyle, combine images | wavespeed edit image "<prompt>" --image @./photo.jpg |
edit_image |
| Video from a prompt, a first/last frame, or references | wavespeed generate video "<prompt>" [--first-frame …] [--ref-image …] |
generate_video |
| Edit a video | wavespeed edit video "<prompt>" --video @./clip.mp4 |
edit_video |
| Continue a video | wavespeed extend video "<prompt>" --video @./clip.mp4 |
extend_video |
They use the same models as the WaveSpeed /chat page and pick the endpoint (text, image, reference, edit) from the inputs you give. In the prompt, refer to media as @image 1, @video 1, @audio 1, in the order given ("put the product in @image 1 into the kitchen in @image 2").
- Price first for videos: CLI
--estimate --json, MCPestimate_only: true. It returns the endpoint, the exact request and the price, and submits nothing. - Models: pass
-m/modelonly when the user names one; a named model is never switched. Without it the default is used, or another model only when the default cannot take the inputs. - Options:
--aspect-ratio,--resolution,--duration(CLI) or the same fields (MCP). Set them only when the user asks; values are snapped to what the model supports, and every change is reported. - CLI: add
--jsonto read the result,--downloadto save files.
Default models
| Default | Alternatives (-m / model) |
|
|---|---|---|
| Image | seedream-5-5 (Seedream 5.5) |
seedream-5-pro, gpt-image-2.6 (GPT Image 2.6, the model behind ChatGPT Images 2.6; strong at text and photorealism), gpt-image-2.5, nano-banana-2.1, nano-banana-pro, nano-banana-2, gpt-image-2 |
| Video | seedance-2.5 (Seedance 2.5) |
seedance-2.5-turbo, kling-4.0, wan-3.0, wan-3.0-prime, minimax-h3 (cheap and fast, native stereo audio; defaults to 768p, its counterpart of 720p), older Seedance 2.0 tiers |
Video resolution is 720p unless the user asks for another (MiniMax H3: 768p). Offer 480p for a cheaper draft.
Everything else: the generic run
Every model on the platform is one wavespeed run <model-id> (MCP: run_model). The model id is always explicit.
# 1. FIND a model in the live catalog (MCP: list_models)
wavespeed models "upscale"
wavespeed models --type text-to-audio --popular
# 2. INSPECT its inputs (MCP: get_model_schema)
wavespeed run <model-id> -h
# 3. RUN it, with --json so you can read the result (MCP: run_model)
wavespeed run <model-id> -p "..." -i key=value --json
run --json returns { id, model, prompt, outputs: [url, ...], saved: [path, ...], elapsed_ms, raw }. Keep id: it is the handle for wavespeed show <id> (MCP: get_prediction) if anything is interrupted. Use the URL when the user wants a link; add --download when they need the file on disk.
# Local files: @path uploads the file and passes its URL
wavespeed run <model-id> -i image=@./photo.jpg --json
wavespeed run <model-id> -i images='["@./a.jpg","@./b.jpg"]' --json
# Or upload separately when you need the URL itself (MCP: upload_file / create_upload)
URL=$(wavespeed upload ./photo.jpg --json | jq -r .url)
# Save outputs with a template
wavespeed run <model-id> -p "..." --download "./out/{index}.{ext}"
The generic run never changes the user's prompt or inputs. The single exception is explicit: an @path value uploads that file and substitutes its hosted URL. Bare paths are never uploaded.
Project config and aliases
If wavespeed.json exists (created by wavespeed init):
defaultModelletswavespeed run -p "…"(no model arg) work.- Aliases are named shortcuts that bundle model + default inputs. Run
wavespeed aliasesto see them;wavespeed run <alias> -hshows the resolved schema. CLI-i k=voverrides alias defaults.
Auth
- CLI:
wavespeed statusshows whether the user is signed in. If not, ask them to runwavespeed login(opens https://wavespeed.ai/accesskey). - MCP: if the tools ask for authorization, the user approves the connection once (in Claude Code:
/mcp, pickwavespeed). - Never ask the user to paste an API key into the chat.
Cost and credits
wavespeed price <id> -i k=v --json(MCP:get_price) estimates a run without generating or charging. The shortcuts have--estimate/estimate_only.wavespeed balance(MCP:get_balance) shows the remaining credit;wavespeed usageandwavespeed billingsshow what was spent.- If a run fails with
Insufficient credits(or says a top-up is required), the balance is too low: do not retry. Tell the user and give them https://wavespeed.ai/top-up. You cannot pay for them.
Pitfalls
- Don't invent model IDs. Confirm with
wavespeed modelsorwavespeed schema <id>(MCP:list_models,get_model_schema) before a generic run. - Local files: use
@./file.jpg. Bare paths are NOT uploaded and the model will reject them. The hosted MCP server cannot read local files at all. wavespeed deleterequires--yeswhen run non-interactively (that includes you).- A run that fails with a gateway or network error (502/503/504, connection reset, timeout) does NOT mean the task failed, and the submit request is never retried automatically on those errors (only an HTTP 429 rate limit, which the API returns before any task exists, is retried), so re-running can create a duplicate paid task. Do not re-run immediately. If the error contains a task id (
task_id/ prediction id), keep checking it withwavespeed show <id> --json(MCP:get_prediction) until its status is terminal (completed,failed,cancelled,timeout,deleted). If no id was returned, check recent predictions withwavespeed history --json(MCP:list_predictions; add the model; default window is the last 24h) and re-run once only if none matches. A client-side wait timeout or an interrupted run does not mean the task failed: tasks can run for a long time, so do not give up after a fixed time.
Fichiers de cette skill
1Questions sur la skill wavespeed
Comment installer la skill wavespeed dans Claude Code ?
Exécutez npx degit WaveSpeedAI/wavespeed-cli/skills ~/.claude/skills/wavespeed. Claude Code charge les skills depuis ~/.claude/skills (tous les projets) ou .claude/skills (un seul projet) et utilise une skill lorsque sa description correspond à la tâche.
Quels clients peuvent utiliser la skill wavespeed ?
Tout client qui lit le format Agent Skills : Claude Code, Codex, Gemini CLI et claude.ai (envoi sous forme de ZIP). Les scripts de la skill ne s'exécutent que si le client autorise l'exécution de code.
Comment puis-je utiliser des fichiers locaux avec les outils MCP de WaveSpeed ?
Le MCP server hébergé ne peut pas lire directement les fichiers locaux. Vous devez transmettre des URL publiques ou utiliser la CLI WaveSpeed avec la syntaxe '@./path' pour télécharger des fichiers depuis votre disque.
Comment puis-je estimer le coût d'une génération vidéo avant de la lancer ?
Vous pouvez utiliser la commande CLI '--estimate --json' ou définir 'estimate_only: true' dans l'outil MCP pour obtenir l'endpoint, les détails de la requête et le prix sans soumettre la tâche.
Que dois-je faire si une exécution échoue avec une erreur réseau de type 502 ou 504 ?
Ne relancez pas la tâche immédiatement, car cela pourrait créer une tâche payante en double. Si un ID de tâche a été renvoyé, vérifiez son statut avec 'wavespeed show <id>'. Si aucun ID n'a été renvoyé, consultez votre historique récent.
Comment télécharger un fichier local pour obtenir une URL utilisable dans d'autres outils ?
Vous pouvez utiliser la commande 'wavespeed upload' pour télécharger un fichier et récupérer son URL hébergée.