Questa pagina descrive la prima versione del pacchetto. Per la versione 0.3, con tutti gli studi, le chiavi API e l’approvazione del prezzo, consulta la nuova guida all’installazione.
Il pacchetto npm yesilcam-studios mette a disposizione due comandi. yesilcam è l’interfaccia a riga di comando: tutto ciò che si fa con un clic nell’app si può eseguire da una shell, con output JSON per lo strumento successivo della catena. yesilcam-mcp è un server Model Context Protocol che consente a Claude di usare gli studi come strumenti. Entrambi usano il normale account e il normale portafoglio di crediti, quindi uno script e un collega che lavora nell’app non entrano mai in conflitto: condividono la stessa coda e lo stesso saldo. Questa guida copre installazione, accesso, comandi principali, configurazione MCP e le abitudini che rendono sicura l’automazione.
Installazione e accesso
- Installa il pacchetto globalmente:
npm install -g yesilcam-studios. - Accedi una volta:
yesilcam login. Il comando chiede le credenziali dell’account e memorizza un token di accesso. - Verifica che funzioni:
yesilcam balancestampa il saldo dei crediti.
Il token viene salvato in ~/.config/yesilcam/config.json con permessi di lettura riservati al proprietario. Esegui yesilcam logout per rimuoverlo, ad esempio prima di cedere un computer. Il token concede pieno accesso all’account, inclusa la spesa di crediti, quindi trattalo come una password: non inserirlo in un commit, non incollarlo in chat condivise e, se temi che sia trapelato, sostituiscilo uscendo e accedendo di nuovo.
Generare dal terminale
yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.pngcrea un’immagine al livello standard e la salva.yesilcam video --from 1234 --duration 5 --waitavvia una clip di cinque secondi a partire dall’immagine 1234 e attende che termini.yesilcam tryon --garment 88 --person 77 --out look.pngesegue una prova con un asset capo e un modello.yesilcam maket analyze plan.dxflegge una pianta e riporta muri, porte, finestre e stanze.yesilcam maket create "Villa",yesilcam maket save ground.dxf --project 12 --floor 0eyesilcam maket plans 12rispecchiano il modello di progetti e piante dell’app.
Aggiungi --json a qualsiasi comando per ottenere un output leggibile dalle macchine; gli id restituiti sono ciò che si passa al comando successivo. --wait resta in attesa fino al termine del lavoro invece di restituire subito un id di lavoro. Ogni lavoro costa esattamente quanto costerebbe nell’app, con il moltiplicatore del piano applicato, e i lavori falliti vengono rimborsati allo stesso modo.
Schemi di scripting
- Un catalogo notturno. Scorri una cartella di foto di capi: carica ciascuna con
yesilcam --json assets upload, leggi l’id dell’asset, poi eseguiyesilcam --json tryoncon--waite--out. Quaranta capi diventano quaranta look mentre dormi. - Storyboard da una sceneggiatura. Suddividi una sceneggiatura in prompt di scena ed esegui in ciclo
yesilcam imageal livello Draft, salvando in una cartella. Esamina la cartella, poi rilancia in Standard solo le immagini da tenere. - Controlli delle piante in CI.
yesilcam maket analyze plan.dxf --jsonrestituisce muri, porte, finestre e stanze rilevati. Fai fallire la build se una pianta non ha stanze o se le sue unità sono state dedotte.
Una regola: quando servono gli id nell’ordine giusto, esegui i lavori uno dopo l’altro anziché in parallelo. Le esecuzioni parallele vanno bene per lavori indipendenti, ma uno script che presuppone che il lavoro 2 sia stato creato dopo il lavoro 1 deve inviarli in sequenza.
Collegare Claude
Il server MCP espone gli studi come strumenti: creare immagini e video, eseguire una prova, controllare lo stato di un lavoro, elencare gli asset della libreria, elencare i personaggi, leggere il saldo, ottenere preventivi e analizzare o salvare piante di Maket. La configurazione richiede due comandi.
- Stampa il token:
yesilcam login --jsone copia il campotoken. - Registra il server in Claude Code:
claude mcp add yesilcam -e YESILCAM_TOKEN=<token> -- yesilcam-mcp.
Claude Desktop legge lo stesso server dal proprio file di configurazione; yesilcam mcp stampa il frammento da incollare lì. Una volta collegato, si descrive il risultato desiderato e Claude mette in sequenza le chiamate: «Fai lo storyboard di queste sei scene in Draft, mostrami i frame, poi produci in Standard le due che scelgo». Claude crea i lavori, attende, restituisce gli URL e, poiché lo strumento dei prezzi è disponibile, può indicare un costo prima di impegnarsi.
Mantenere una persona nel ciclo
Il lavoro in Draft può essere autonomo. La produzione Standard e Cinema dovrebbe attendere il tuo sì esplicito, perché è lì che si spendono i crediti. Dillo nelle istruzioni («chiedi prima di qualsiasi lavoro sopra Draft») e Claude chiederà. Lo stesso vale per gli script: metti il livello in una variabile, imposta Draft come valore predefinito e rendi i livelli superiori un flag esplicito. Controlla il saldo prima di un batch lungo, e ricorda che il portafoglio è condiviso con l’app: un collega che produce un film nello stesso momento attinge agli stessi crediti.
Risoluzione dei problemi
- Comando non trovato. La cartella in cui npm installa i binari globali non è nel PATH. Aggiungila e apri una nuova shell.
- Non autorizzato. Il token memorizzato è stato rimosso, oppure il file di configurazione è stato cancellato. Esegui di nuovo
yesilcam login. - Il server MCP non compare. Il nome della variabile d’ambiente è
YESILCAM_TOKENe il valore è il token ottenuto dayesilcam login --json, non la password. Riavvia il client dopo aver aggiunto il server. - Un lavoro non restituisce alcun risultato. Controllane lo stato; un lavoro fallito viene rimborsato e può essere inviato di nuovo.
Domande frequenti
La CLI ha un costo aggiuntivo? No. Usa lo stesso portafoglio di crediti e gli stessi prezzi dell’app.
Dove viene memorizzato il token? In ~/.config/yesilcam/config.json, leggibile solo dal tuo utente. yesilcam logout lo elimina.
Claude può spendere crediti senza chiedere? Solo se lo consenti tu. Ogni strumento riporta il lavoro e il suo stato, lo strumento dei prezzi permette di ottenere prima un preventivo e un’istruzione di chiedere conferma prima dei livelli superiori a Draft viene rispettata.
Posso usare la CLI e l’app contemporaneamente? Sì. I lavori di entrambe compaiono nella stessa coda e nella stessa Libreria.
