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 comando yesilcam apre gli studi agli script. Tutto ciò che clicchi nell'app puoi eseguirlo da una shell, con output JSON per lo strumento successivo della catena. Usa il tuo normale account e lo stesso portafoglio di crediti, quindi uno script e un collega nell'app non vedono mai saldi diversi né prezzi diversi. Ecco come lo usiamo, e le poche regole che evitano che la produzione automatizzata ti riservi sorprese.
Installazione e accesso, una volta sola
Il pacchetto è yesilcam-studios, da installare globalmente con npm. Esegui yesilcam login, poi yesilcam balance per verificare che il portafoglio sia visibile. Il token viene salvato in ~/.config/yesilcam/config.json con permessi riservati al solo proprietario; yesilcam logout lo rimuove. Tieni il token privato, perché concede pieno accesso all'account, e non inserire il file di configurazione in nessun commit.
I comandi che userai davvero
yesilcam image "a lighthouse at dusk, 35mm film" --tier standard --out lighthouse.pnggenera un'immagine a un dato livello e la salva.yesilcam video --from 1234 --duration 5 --waitanima una risorsa esistente e attende il risultato.yesilcam tryon --garment 88 --person 77 --out look.pngesegue una prova virtuale di un capo su una modella.yesilcam assets upload file.pngcarica un file nella tua libreria e ne restituisce l'id.yesilcam maket analyze plan.dxfriporta che cosa contiene una pianta;yesilcam maket create "Villa"eyesilcam maket save ground.dxf --project 12 --floor 0archiviano le piante nei progetti.
Aggiungi --json a uno qualsiasi di questi per ottenere un output leggibile dalle macchine. Quell'opzione è il senso stesso della CLI: trasforma ogni studio in un passaggio di una pipeline che controlli tu.
Un catalogo notturno
Il ciclo che eseguiamo per un cliente di moda funziona così: per ogni foto di un capo in una cartella, la carichiamo con yesilcam --json assets upload, leggiamo l'id della risorsa dal JSON, poi eseguiamo yesilcam --json tryon con quell'id del capo e l'id della modella, con --wait e un percorso di output che porta il nome del file del capo. Al mattino una cartella di foto di capi è diventata una cartella di look, ciascuno con la sua provenienza registrata nel registro sotto gli stessi id di lavoro stampati nel JSON. Le nuove varianti di colore arrivano nella cartella e vengono elaborate la notte successiva senza che nessuno apra l'app.
Storyboard da una sceneggiatura
Dividi una sceneggiatura in prompt di scena, uno per riga, ed esegui in ciclo yesilcam image su di essi al livello Draft, con file di output numerati. Esamina la cartella come una striscia. Poi riesegui al livello Standard solo quelli da tenere. Il passaggio Draft costa una frazione di quello Standard, e la revisione avviene in un gestore di file invece che in una coda, che è il modo in cui preferiamo guardare trenta fotogrammi tutti insieme.
Controllo delle piante nella CI
yesilcam maket analyze plan.dxf --json restituisce muri, porte, finestre e locali. Fai fallire la build se una pianta non ha locali o se le sue unità sono state stimate. Uno studio di architettura che esporta i DXF da un modello può intercettare uno schema di layer difettoso prima che qualcuno metta il file davanti a un cliente, e il controllo richiede un secondo.
Regole che mantengono onesti gli script
- Esegui i lavori in sequenza quando ti servono i loro id in ordine. La coda è condivisa con l'app; uno script che lancia venti lavori in parallelo li riceve indietro nell'ordine in cui finiscono.
- Controlla prima il saldo.
yesilcam balance --jsonprima di una serie, e fermati se non basta. Uno script che svuota il portafoglio alle 3 di notte è uno script che fallisce a metà di una serie. - Usa Draft per tutto ciò che guarderai prima di tenerlo. L'automazione rende facile spendere al livello Standard per impostazione predefinita. Non farlo.
- Conserva gli id dei lavori. Sono il modo per trovare la risorsa nella libreria, il modo in cui il registro spiega un addebito e il modo per ricostruire un rimborso se un lavoro è fallito.
- Non analizzare l'output pensato per le persone. Sempre
--json. Il formato leggibile è per gli occhi e può cambiare.
Che cosa non fa la CLI
Non aggira i prezzi né il portafoglio; ogni operazione costa quanto costa nell'app, con il moltiplicatore del tuo piano applicato. Non esegue la conversione 3D di Maket, che avviene nel browser; analizza e archivia le piante. E non ritenta per te i lavori falliti. I fallimenti vengono rimborsati automaticamente e il JSON ti dice quale lavoro è fallito, ma la decisione di rieseguirlo spetta a te.
Domande frequenti
Due persone possono condividere un token della CLI? Non dovrebbero. Il token concede pieno accesso all'account da cui proviene. Ogni persona accede con il proprio account, e il portafoglio da cui spende è il suo.
Uno script vede gli stessi prezzi dell'app? Sì. La CLI, l'app, gli strumenti MCP e la pagina dei prezzi leggono la stessa tabella in tempo reale, quindi c'è un solo prezzo per operazione ovunque.
Dove finiscono gli output? Nella tua libreria, come accadrebbe dall'app, e nel percorso indicato con --out. Nulla di ciò che viene generato da uno script è nascosto all'app.
