Ogni strumento del server MCP di Yeşilçam Studios ha un comando identico nella CLI yesilcam, perché entrambi nascono da un unico catalogo. Lo strumento MCP yesilcam_image_create corrisponde al comando yesilcam image create, yesilcam_longvideo_plan a yesilcam longvideo plan, e così via. Questa guida raccoglie ricette funzionanti per ogni studio, ciascuna con un comando e, dove serve, una richiesta da dare al tuo assistente. I comandi a pagamento qui sotto includono --yes per partire in un colpo solo; se lo togli, la CLI ti mostra il prezzo e chiede prima, come spiegato nella guida all’approvazione dei token.
Come aspetto i risultati e li scarico?
La maggior parte degli studi lavora in background. Aggiungi --wait per seguire l’avanzamento fino alla fine del lavoro, oppure --out <path> per aspettare e scaricare il risultato in un file o in una cartella. Se hai avviato un lavoro senza aspettare, riprendilo più tardi con yesilcam wait <kind> <id>; quando restituisce un lavoro, la CLI stampa il comando esatto. Gli assistenti usano wait=true e save_to, oppure lo strumento yesilcam_wait.
Image Studio
yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --aspect 16:9 --yes --out lighthouse.png
Richiesta: "Crea un’immagine in bozza 16:9 di un faro al tramonto. Dimmi prima il prezzo, poi salvala sulla mia scrivania." Lo stesso strumento modifica un’immagine esistente, usa i tuoi personaggi salvati e le immagini di riferimento, e accetta un prompt negativo.
Film Studio
yesilcam video create "ocean waves at sunset" --tier draft --duration 5 --quote
yesilcam video characters "two friends laugh on a tram" --character-ids 140,141 --first-frame-approval --yes
yesilcam video first-frame --video-job-id <id> --action approve
Il primo comando mostra solo il prezzo di una clip in bozza da cinque secondi. Il secondo crea un video con due dei tuoi personaggi salvati e si ferma sul primo fotogramma in attesa della tua approvazione; il terzo lo approva. Per i film da una storia (Pro):
yesilcam film story "<your story>" --style anime --target-seconds 60 --yes --wait
yesilcam film produce <flow_id>
Story to Film crea prima un cast, uno storyboard e le scene. Puoi modificare le scene con yesilcam film scene prima di produrre il film. Lip sync, voci, personaggi e Character Bible sono nello stesso gruppo (yesilcam video --help, yesilcam characters --help).
Animation Studio, Ink Landscape, Inkmation e Custom
yesilcam animation create "a boatman crosses a misty river" --style inkland --palette ink --season autumn --tier professional --yes --wait
yesilcam animation render <id> --format gif --yes --out film.gif
yesilcam inkmation create "<story>" --platform youtube-shorts --seconds 30 --languages en --yes
yesilcam animation custom --image-asset-id 2082 --prompt "she turns and smiles" --duration 5 --camera '[{"axis":"zoom","value":3,"seconds":5}]' --yes
yesilcam animation styles elenca gratis i 25 stili. I render escono in MP4 (HD o 4K), WebP o GIF. Custom anima una tua immagine lungo un percorso di camera indicato in JSON.
Cinema Studio
yesilcam cinema narrate "Welcome to Yeşilçam Studios." --voice calm_narrator --yes
yesilcam cinema render <project_id> --resolution 1080p --yes --wait
La narrazione viene salvata nella tua libreria. Sono disponibili esportazione, narrazione, un presentatore parlante da una foto e sottotitoli automatici; la modifica della timeline vera e propria resta nell’app.
Design Studio
yesilcam design generate "jazz night poster" --preset a3 --style retro --quality draft --texts "Jazz Night,Friday 21:00" --yes --wait
yesilcam design export <design_id> --format pdf --cmyk --pdfx x4 --bleed --marks --yes --out poster.pdf
I formati di esportazione sono PNG, JPG, WebP, PDF per la stampa (CMYK, PDF/X), SVG ed EPS. yesilcam design presets elenca gratis formati della tela e stili.
Website Studio, Website Promo, Montaggio / Smontaggio
yesilcam assemble create --description "a mechanical wristwatch" --duration 5 --yes --wait
yesilcam website create --source-project-id <id> --brand "Atelier" --lang en --yes --wait
yesilcam website manage <site_id> --action preview_link
yesilcam promo create https://example.com --seconds 30 --yes --wait
yesilcam promo produce <id> --yes --wait
Un video di Montaggio / Smontaggio diventa la base di un sito prodotto a scorrimento. Website Promo lavora in due passaggi: prima il copione, che puoi rivedere e modificare con yesilcam promo script, poi il video narrato.
Fashion Try-On
yesilcam fashion tryon --garment-path tee.png --person-asset-id 2082 --yes --out look.png
yesilcam fashion stylist "summer wedding" --character-id 141 --yes
Puoi anche importare un capo da una pagina prodotto con yesilcam fashion import <url>, mostrare un look su un’altra corporatura e, con Pro, trasformare una prova in un fashion film.
Maket
yesilcam maket analyze plan.dxf
yesilcam maket save plan.dxf --new-project "Villa" --floor 0
yesilcam maket from-image scan.jpg --new-project "Flat" --yes
maket analyze gira sul tuo computer ed è gratuito. Una pianta da una foto o da una scansione si paga in base all’uso. Arredamento e progettazione del verde richiedono l’editor 3D nell’app.
AI Influencer Studio
yesilcam discover copy arjun --yes
yesilcam influencer voice-set --influencer-id 70 --voice <id> --lang tr
yesilcam influencer video --mode scene --influencer-id 70 --prompt "raises his coffee on a sunny terrace" --speech-lines '[{"text":"Coffee first."}]' --yes --wait
Il primo comando copia nel tuo account un influencer già pronto da Discover; gli altri ne impostano voce e lingua e creano un video di scena con una battuta parlata. Per crearne uno tuo usa yesilcam influencer create; con la tua foto aggiungi --photo-path me.jpg --photo-consent (Basic o Pro). Video lunghi da 15 secondi a 10 minuti:
yesilcam longvideo plan --influencer-id 70 --topic "3 tips for better phone photos" --seconds 60 --format mixed --yes --wait
yesilcam longvideo get <id>
yesilcam longvideo produce <id> --yes
Il piano ti dà uno storyboard modificabile e un preventivo, e la durata finale resta entro ±5% dell’obiettivo. Prima della produzione puoi salvare uno storyboard modificato con longvideo save --storyboard @sb.json e vedere i fotogrammi di anteprima con longvideo frames. I video programmati arrivano dalle automazioni:
yesilcam automation save --influencer-id 70 --sector "specialty coffee" --days 1,4 --times 10:00 --timezone Europe/Istanbul --monthly-cap 1000000 --yes
Salvarla autorizza una spesa fino al tetto mensile. Le esecuzioni in attesa di revisione si approvano o si saltano con automation review, e automation control mette in pausa, riprende o elimina. I comandi di pubblicazione social esistono, ma rispondono "in arrivo" finché la pubblicazione non si apre per il tuo account; gli account si collegano solo nell’app web.
Libreria e provenienza
yesilcam library list --kind video --limit 3
yesilcam library upload ./photo.jpg --label "Product front"
yesilcam library lineage asset <id>
La provenienza mostra da dove arriva un file e cosa è stato creato a partire da esso. Richiesta: "Elenca gli ultimi tre video della mia libreria, scarica il più recente e dimmi da quale lavoro arriva."
Script e JSON
Metti --json prima del comando (yesilcam --json image ...) per avere un output leggibile dalle macchine, e prendi gli id da lì invece che dal testo per le persone. Controlla i codici di uscita: 3 significa che è stato mostrato un preventivo non approvato, 2 che non hai effettuato l’accesso. Esegui i lavori uno dopo l’altro quando conta l’ordine dei loro id.
Cosa resta nell’app web?
Acquisto di token o piani, fatturazione, ricariche automatiche per le automazioni, collegamento degli account social, creazione e revoca delle chiavi API ed eliminazione dell’account. Inoltre arredamento e progettazione del verde in Maket, modifica della timeline di Cinema Studio, navigazione e like su The Wall, e le gallerie di modelli per immagini e video (dove indicato, i modelli si possono usare tramite id).
Domande frequenti
Come trovo le opzioni di un comando? Aggiungi --help: yesilcam influencer video --help elenca tutte le opzioni con i valori ammessi. Il server MCP dà all’assistente le stesse descrizioni.
Dove finiscono i risultati? Nella tua libreria, come con l’app, e nel percorso indicato con --out o save_to.
Posso passare valori JSON lunghi da un file? Sì. Le opzioni che accettano JSON accettano anche @file.json, per esempio uno storyboard o un percorso di camera.
