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.
La commande yesilcam ouvre les studios aux scripts. Tout ce que vous cliquez dans l'application, vous pouvez le lancer depuis un shell, avec une sortie JSON pour l'outil suivant de la chaîne. Elle utilise votre compte habituel et le même portefeuille de crédits, si bien qu'un script et un collègue dans l'application ne voient jamais des soldes ni des prix différents. Voici comment nous l'utilisons, et la poignée de règles qui évitent qu'une production automatisée ne vous réserve des surprises.
Installer et se connecter une fois
Le paquet s'appelle yesilcam-studios et s'installe globalement avec npm. Lancez yesilcam login, puis yesilcam balance pour vérifier que le portefeuille est visible. Le jeton d'accès est enregistré dans ~/.config/yesilcam/config.json avec des droits réservés au propriétaire ; yesilcam logout le supprime. Gardez ce jeton privé, car il donne un accès complet au compte, et ne versionnez le fichier de configuration nulle part.
Les commandes que vous utiliserez vraiment
yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.pnggénère une image à un niveau donné et l'enregistre.yesilcam video --from 1234 --duration 5 --waitanime un asset existant et attend le résultat.yesilcam tryon --garment 88 --person 77 --out look.pnglance un essayage d'un asset vêtement sur un mannequin.yesilcam assets upload file.pngplace un fichier dans votre bibliothèque et renvoie son identifiant.yesilcam maket analyze plan.dxfindique ce que contient un plan ;yesilcam maket create "Villa"etyesilcam maket save ground.dxf --project 12 --floor 0classent les plans dans des projets.
Ajoutez --json à n'importe laquelle pour obtenir une sortie lisible par une machine. Ce drapeau est toute la raison d'être de la CLI : il transforme chaque studio en étape d'un pipeline qui vous appartient.
Un catalogue nocturne
La boucle que nous faisons tourner pour un client de mode ressemble à ceci : pour chaque photo de vêtement d'un dossier, on la téléverse avec yesilcam --json assets upload, on lit l'identifiant de l'asset dans le JSON, puis on lance yesilcam --json tryon avec cet identifiant de vêtement et celui du mannequin, avec --wait et un chemin de sortie nommé d'après le fichier du vêtement. Au matin, un dossier de photos de vêtements est devenu un dossier de looks, chacun avec sa traçabilité consignée dans le registre sous les mêmes identifiants de tâche que ceux imprimés par le JSON. Les nouveaux coloris arrivent dans le dossier et sont traités la nuit suivante sans que personne n'ouvre l'application.
Des storyboards à partir d'un script
Découpez un scénario en prompts de scène, un par ligne, et bouclez yesilcam image dessus au niveau Draft, avec des fichiers de sortie numérotés. Passez le dossier en revue comme une planche. Relancez ensuite uniquement les images retenues au niveau Standard. La passe Draft coûte une fraction de la passe Standard, et la revue se fait dans un explorateur de fichiers plutôt que dans une file d'attente, ce qui est notre façon préférée de regarder trente images d'un coup.
Contrôler les plans en CI
yesilcam maket analyze plan.dxf --json renvoie murs, portes, fenêtres et pièces. Faites échouer le build si un plan n'a aucune pièce ou si ses unités ont été devinées. Une agence d'architecture qui exporte ses DXF depuis un gabarit peut ainsi repérer un schéma de calques cassé avant que quiconque ne présente le fichier à un client, et le contrôle prend une seconde.
Les règles qui gardent les scripts honnêtes
- Lancez les tâches l'une après l'autre quand vous avez besoin de leurs identifiants dans l'ordre. La file est partagée avec l'application ; un script qui envoie vingt tâches en parallèle les récupère dans l'ordre où elles se terminent.
- Vérifiez d'abord le solde.
yesilcam balance --jsonavant un lot, et arrêtez-vous s'il est insuffisant. Un script qui vide le portefeuille à 3 heures du matin est un script qui rate la moitié d'un lot. - Utilisez Draft pour tout ce que vous regarderez avant de le garder. L'automatisation rend facile de dépenser en Standard par défaut. Ne le faites pas.
- Conservez les identifiants de tâche. C'est grâce à eux que vous retrouvez l'asset dans la bibliothèque, que le registre explique un débit et qu'un remboursement est retracé si une tâche a échoué.
- N'analysez pas la sortie destinée aux humains. Toujours
--json. Le format humain est fait pour les yeux et peut changer.
Ce que la CLI ne fait pas
Elle ne contourne ni la tarification ni le portefeuille ; chaque opération coûte ce qu'elle coûte dans l'application, avec le multiplicateur de votre abonnement appliqué. Elle n'exécute pas la conversion 3D de Maket, qui se fait dans le navigateur ; elle analyse et classe les plans. Et elle ne relance pas les tâches échouées à votre place. Les échecs sont remboursés automatiquement, et le JSON vous dit quelle tâche a échoué, mais la décision de relancer vous appartient.
Questions fréquentes
Deux personnes peuvent-elles partager un même jeton de CLI ? Elles ne devraient pas. Le jeton donne un accès complet au compte dont il provient. Chaque personne se connecte avec son propre compte, et le portefeuille qu'elle utilise est le sien.
Un script voit-il les mêmes prix que l'application ? Oui. La CLI, l'application, les outils MCP et la page des tarifs lisent la même table en direct, il y a donc un seul prix par opération, partout.
Où vont les résultats ? Dans votre bibliothèque, comme depuis l'application, et vers le chemin que vous indiquez avec --out. Rien de ce qu'un script génère n'est caché à l'application.
