Se connecter

WaveSpeed CLI · MCP

Générez images et vidéos depuis Claude Code, Codex et votre terminal

Une CLI open-source pour exécuter n'importe quel modèle d'IA WaveSpeed. Image, vidéo, audio, 3D. Conçue pour les terminaux et les agents de code comme Codex, Claude Code, Claude Cowork et Cursor.

CLI

@wavespeed/cli

Installez une fois, lancez n'importe quel modèle depuis votre shell ou vos scripts.

$npm install -g @wavespeed/cli
Installer depuis npmVoir sur GitHub

MCP

@wavespeed/mcp

Serveur MCP hébergé : ajoutez-le par son adresse dans n'importe quel client MCP et connectez-vous.

https://api.wavespeed.ai/mcp
Choisissez votre agentVoir sur GitHub

Configurez WaveSpeed dans votre agent

Choisissez votre outil pour la configuration la plus rapide. Chaque option donne accès au catalogue complet, avec le prix avant de dépenser.

Claude Code

Plugin

Ajoute le serveur MCP hébergé et la skill WaveSpeed en une seule installation.

  1. 1

    Ajoutez le marketplace WaveSpeed

    $claude plugin marketplace add WaveSpeedAI/claude-plugins
  2. 2

    Installez le plugin

    $claude plugin install wavespeed@wavespeed
  3. 3

    Dans Claude Code, lancez /mcp, choisissez wavespeed et approuvez la connexion dans le navigateur

    /mcp
Puis demandez : “Crée une image hero 16:9 d'un skyline cyberpunk et donne-moi d'abord le prix.”

Autres méthodes

Le serveur MCP seul, sans la skill :

$claude mcp add --transport http wavespeed https://api.wavespeed.ai/mcp
GitHub

Trois commandes et vous expédiez

  1. 1

    Installer

    Node 18+ requis. Une installation globale rend le binaire wavespeed disponible partout.

    $npm install -g @wavespeed/cli
  2. 2

    Se connecter

    Ouvre la page de clé d'accès dans votre navigateur. Nous détectons automatiquement une clé copiée et la validons en direct.

    $wavespeed login
  3. 3

    Exécuter n'importe quel modèle

    Même forme pour tous les modèles. Passez l'ID du modèle et les entrées — récupérez une URL CDN ou canalisez --json vers vos scripts.

    $wavespeed run wavespeed-ai/z-image/turbo -p "a cat"

  • Apprenez la CLI à votre agent

    Installe une skill pour que Codex, Claude Code, Cursor et d'autres agents sachent l'utiliser.

    $wavespeed skill install

  • Pas de Node.js ?

    Sous macOS et Linux, vous pouvez installer un exécutable autonome. Sous Windows, téléchargez-le depuis GitHub Releases.

    $curl -fsSL https://raw.githubusercontent.com/WaveSpeedAI/wavespeed-cli/main/install.sh | bash

  • Restez à jour

    Passez à la dernière version avec une seule commande.

    $wavespeed upgrade

  • Utilisez les modèles WaveSpeed dans votre agent de programmation

    Configurez Claude Code, Codex, OpenCode et d'autres pour utiliser l'API LLM de WaveSpeed. Annulable à tout moment.

    $wavespeed setup

Conçue pour les humains et les agents

Aide dynamique par modèle

Exécutez wavespeed run <model> -h et la CLI récupère en direct le schéma d'entrée de ce modèle et affiche les flags exacts qu'il accepte — pas de devinette.

Des alias qui voyagent avec votre repo

Définissez des raccourcis nommés dans wavespeed.json qui regroupent un modèle + des entrées par défaut. Les équipes récupèrent le fichier, tapent wavespeed run hero, obtiennent un rendu conforme à la marque.

Conçue pour les agents

Chaque commande prend en charge --json sur stdout et la progression sur stderr. Déposez un SKILL.md pour que Codex, Claude Code, Claude Cowork et Cursor sachent l'appeler.

Pas de magie, pas de démon

La CLI ne modifie jamais votre prompt et n'ouvre aucun processus en arrière-plan. Elle appelle api.wavespeed.ai directement. Open source, licence MIT.

À quoi ressemble une vraie session

De la navigation dans le catalogue à la sortie JSON — trois commandes.

~/projects/marketing
# 1. browse the catalog
$ wavespeed models --type text-to-image --popular

# 2. inspect a model's inputs — schema fetched live
$ wavespeed run wavespeed-ai/z-image/turbo -h
  * prompt          string
    size            string   default: "1024*1024"
    strength        number   default: 0.6   range: 0..1
    output_format   string   default: "jpeg"   enum: jpeg | png | webp

# 3. run — JSON out so you can pipe it
$ wavespeed run wavespeed-ai/z-image/turbo \
    -p "a cyberpunk skyline at golden hour" --json
{
  "model": "wavespeed-ai/z-image/turbo",
  "outputs": ["https://example.com/output/skyline.jpeg"],
  "elapsed_ms": 4718
}

Générez images et vidéos depuis Claude Code et Codex

Installez la CLI et son skill une fois, puis demandez simplement. Votre agent de code lance les commandes et enregistre les fichiers dans votre projet.

Claude Code · WaveSpeed CLI

Crée un visuel 16:9 pour la landing page de mon café : chaleureux, au lever du soleil, avec de la place pour un titre.

Un café chaleureux au lever du soleil, vu depuis la rue

Voici votre visuel : la lumière chaude du lever du soleil sur la devanture, cadré large pour une bannière. · Coût $0.045

generate image
$ wavespeed generate image "cozy coffee shop at sunrise, warm light in the windows, room for a headline" --aspect-ratio 16:9 --download

Super. Écris "Open at 7" sur la vitrine.

Le même café avec "Open at 7" peint sur la vitrine

C’est fait : "Open at 7" est peint à la main sur la vitrine, le reste n’a pas changé. · Coût $0.045

edit image
$ wavespeed edit image "add the words \"Open at 7\" in white hand lettering on the front window" --image @./hero.jpg --download

Générer des images et des vidéos depuis votre agent de code

Comment générer des images depuis Claude Code ?

Installez la CLI avec npm install -g @wavespeed/cli, connectez-vous avec wavespeed login et ajoutez le skill avec wavespeed skill install. Demandez ensuite une image à Claude Code : il lance wavespeed generate image et enregistre le fichier dans votre projet.

Comment générer des images et des vidéos depuis Codex ?

Installez la CLI, connectez-vous, puis lancez wavespeed skill install pour que Codex connaisse les commandes. Demandez une image ou une vidéo à Codex et il les exécute pour vous, ou installez le plugin WaveSpeed depuis /plugins.

Qu’est-ce que l’agent exécute vraiment ?

Des commandes simples que vous pouvez lire et relancer : wavespeed generate image, wavespeed edit image, wavespeed generate video. Les fichiers locaux sont passés avec @./file et les résultats téléchargés avec --download.

Est-ce que ça marche dans Cursor et d’autres agents de code ?

Oui. Tout agent capable de lancer des commandes dans le terminal peut utiliser la CLI, et le skill lui apprend les commandes. Les agents compatibles MCP peuvent aussi se connecter au serveur hébergé.

Puis-je aussi générer des vidéos ?

Oui. wavespeed generate video crée un clip à partir d’un texte, d’une image de départ ou d’images de référence, et wavespeed edit video et extend video modifient ou prolongent une vidéo existante.

Combien ça coûte ?

Vous payez à la génération depuis votre solde WaveSpeed, sans abonnement. Ajoutez --estimate pour voir le prix avant toute exécution ; chaque résultat indique ce qu’il a coûté.

Ce que votre agent peut faire via MCP

Des outils raccourcis pour le travail quotidien sur l'image et la vidéo, plus tout le catalogue : chercher des modèles, lire leurs vraies entrées, obtenir le prix, puis lancer.

generate_image

Créer une image à partir d'un prompt, avec des images de référence en option

edit_image

Modifier, restyler ou combiner des images existantes

generate_video

Créer une vidéo à partir d'un prompt, d'une première image ou de références

edit_video

Changer ce qui se passe dans une vidéo existante

extend_video

Prolonger une vidéo avec de nouvelles images

list_models

Rechercher dans le catalogue en direct par texte ou par type

get_model_schema

Les vraies entrées d'un modèle, champs obligatoires et valeurs par défaut

run_model

Lancer n'importe quel modèle ; les entrées @fichier locales sont envoyées automatiquement

get_price

Obtenir le coût avant de dépenser

get_balance

Consulter votre solde de crédits

upload_file

Transformer un fichier local en URL hébergée

get_prediction

Reprendre une génération longue grâce à son id

list_predictions

Consulter l'historique de vos générations

list_billings

Voir les débits et remboursements détaillés

get_usage

Suivre les dépenses et l'usage par jour et par modèle

delete_predictions

Supprimer des exécutions de l'historique (demande d'abord)

upload_file n’existe que dans le serveur local. Le serveur distant ne peut pas lire vos fichiers : passez des URL publiques, utilisez create_upload depuis un outil capable d’envoyer des requêtes HTTP, ou, dans ChatGPT, joignez le fichier à la conversation.

GitHubnpmDocs

Open source. Prête aujourd'hui.

Licence MIT, publiée sous @wavespeed sur npm, hébergée sur GitHub. Issues et PR bienvenus.

CLIInstaller depuis npmMettre une étoile sur GitHub
MCPChoisissez votre agentMettre une étoile sur GitHub

Vous préférez une application graphique ? Essayez WaveSpeed DesktopVoir toutes les façons de se connecter à WaveSpeed

Seedream 5.5 est EN LIGNE | Essayez-le dans le générateur d'images →