Cette page décrit la première version du paquet. Pour la version 0.3, avec tous les studios, les clés API et la validation du prix, consultez le nouveau guide d’installation.

Le paquet npm yesilcam-studios vous fournit deux commandes. yesilcam est l’interface en ligne de commande : tout ce que vous faites en cliquant dans l’application, vous pouvez l’exécuter depuis un terminal, avec une sortie JSON pour l’outil suivant de la chaîne. yesilcam-mcp est un serveur Model Context Protocol qui permet à Claude d’utiliser les studios comme des outils. Les deux utilisent votre compte habituel et votre portefeuille de crédits habituel : un script et un collègue travaillant dans l’application n’entrent jamais en conflit, puisqu’ils partagent la même file d’attente et le même solde. Ce guide couvre l’installation, la connexion, les principales commandes, la configuration MCP et les bonnes pratiques qui sécurisent l’automatisation.

Installer et se connecter

  1. Installez le paquet globalement : npm install -g yesilcam-studios.
  2. Connectez-vous une fois : yesilcam login. La commande demande les identifiants de votre compte et enregistre un jeton d’accès.
  3. Vérifiez que tout fonctionne : yesilcam balance affiche votre solde de crédits.

Le jeton d’accès est enregistré dans ~/.config/yesilcam/config.json, avec des permissions réservées au propriétaire du fichier. Exécutez yesilcam logout pour le supprimer, par exemple avant de céder une machine. Ce jeton donne un accès complet au compte, y compris la dépense de crédits : traitez-le comme un mot de passe. Ne le versionnez pas, ne le collez pas dans des conversations partagées, et remplacez-le en vous déconnectant puis en vous reconnectant s’il a pu fuiter.

Générer depuis le terminal

  • yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.png crée une image au niveau Standard et l’enregistre.
  • yesilcam video --from 1234 --duration 5 --wait lance un clip de cinq secondes à partir de l’image 1234 et attend qu’il soit terminé.
  • yesilcam tryon --garment 88 --person 77 --out look.png exécute un essayage avec un vêtement importé et un mannequin.
  • yesilcam maket analyze plan.dxf lit un plan et rend compte des murs, portes, fenêtres et pièces.
  • yesilcam maket create "Villa", yesilcam maket save ground.dxf --project 12 --floor 0 et yesilcam maket plans 12 reproduisent le modèle de projets et de plans de l’application.

Ajoutez --json à n’importe quelle commande pour obtenir une sortie exploitable par une machine ; les identifiants renvoyés sont ceux que vous transmettez à la commande suivante. --wait bloque jusqu’à la fin de la tâche au lieu de rendre la main immédiatement avec un identifiant de tâche. Chaque tâche coûte exactement ce qu’elle coûterait dans l’application, multiplicateur de votre offre appliqué, et les tâches échouées sont remboursées de la même manière.

Modèles de scripts

  • Un catalogue nocturne. Parcourez en boucle un dossier de photos de vêtements : importez chacune avec yesilcam --json assets upload, lisez l’identifiant de la ressource, puis exécutez yesilcam --json tryon avec --wait et --out. Quarante vêtements deviennent quarante looks pendant que vous dormez.
  • Des storyboards à partir d’un scénario. Découpez un scénario en prompts de scène et lancez yesilcam image en boucle au niveau Draft, vers un dossier. Passez le dossier en revue, puis ne relancez en Standard que les images retenues.
  • Vérification des plans en CI. yesilcam maket analyze plan.dxf --json renvoie les murs, portes, fenêtres et pièces détectés. Faites échouer le build si un plan ne contient aucune pièce ou si ses unités ont dû être devinées.

Une règle : exécutez les tâches l’une après l’autre plutôt qu’en parallèle lorsque vous avez besoin de leurs identifiants dans l’ordre. Les exécutions parallèles conviennent aux travaux indépendants, mais un script qui suppose que la tâche 2 a été créée après la tâche 1 doit les soumettre séquentiellement.

Connecter Claude

Le serveur MCP expose les studios sous forme d’outils : créer une image ou une vidéo, lancer un essayage, vérifier l’état d’une tâche, lister les ressources de la bibliothèque, lister les personnages, lire le solde, obtenir un devis, et analyser ou enregistrer des plans Maket. La configuration tient en deux commandes.

  1. Affichez votre jeton d’accès : yesilcam login --json, puis copiez le champ token.
  2. Enregistrez le serveur auprès de Claude Code : claude mcp add yesilcam -e YESILCAM_TOKEN=<token> -- yesilcam-mcp.

Claude Desktop lit le même serveur depuis son fichier de configuration ; yesilcam mcp affiche l’extrait à y coller. Une fois connecté, vous décrivez le résultat attendu et Claude enchaîne les appels : « Fais le storyboard de ces six scènes en Draft, montre-moi les images, puis produis en Standard les deux que je choisis. » Il crée les tâches, attend, renvoie les URL et, comme l’outil de tarification est disponible, peut annoncer un coût avant de s’engager.

Garder un humain dans la boucle

Le travail en Draft peut être autonome. La production en Standard et en Cinema doit attendre votre accord explicite, car c’est là que partent les crédits. Précisez-le dans vos instructions (« demande-moi avant toute tâche au-delà du niveau Draft ») et Claude vous demandera. Il en va de même pour les scripts : placez le niveau dans une variable, avec Draft par défaut, et faites des niveaux supérieurs une option explicite. Vérifiez le solde avant un long lot, et gardez à l’esprit que le portefeuille est partagé avec l’application : un collègue qui produit un film au même moment puise dans les mêmes crédits.

Dépannage

  • Commande introuvable. Le répertoire où npm installe les binaires globaux n’est pas dans votre PATH. Ajoutez-le et ouvrez un nouveau terminal.
  • Non autorisé. Le jeton enregistré a été supprimé, ou le fichier de configuration a été effacé. Exécutez à nouveau yesilcam login.
  • Le serveur MCP n’apparaît pas. Le nom de la variable d’environnement est YESILCAM_TOKEN et sa valeur est le jeton renvoyé par yesilcam login --json, pas votre mot de passe. Redémarrez le client après avoir ajouté le serveur.
  • Une tâche ne renvoie aucun résultat. Vérifiez son état ; une tâche échouée est remboursée et peut être soumise à nouveau.

Questions fréquentes

La CLI coûte-t-elle plus cher ? Non. Elle utilise le même portefeuille de crédits et les mêmes prix que l’application.

Où le jeton d’accès est-il enregistré ? Dans ~/.config/yesilcam/config.json, lisible uniquement par votre utilisateur. yesilcam logout le supprime.

Claude peut-il dépenser des crédits sans demander ? Seulement si vous le lui permettez. Chaque outil indique la tâche et son état, l’outil de tarification lui permet d’annoncer un coût d’abord, et une instruction lui demandant de vous consulter avant tout niveau autre que Draft est respectée.

Puis-je utiliser la CLI et l’application en même temps ? Oui. Les tâches des deux apparaissent dans la même file d’attente et dans la même Bibliothèque.