Every tool of the Yeşilçam Studios MCP server has an identical command in the yesilcam CLI, because both are generated from one catalog. The MCP tool yesilcam_image_create is the command yesilcam image create, yesilcam_longvideo_plan is yesilcam longvideo plan, and so on. This guide collects working recipes per studio, each with a command and, where it helps, a prompt you can give your assistant. Paid commands below include --yes so they run in one go; leave it out and the CLI shows the price and asks first, as described in the token approval guide.

How do I wait for results and download them?

Most studios run in the background. Add --wait to follow progress until the job is done, or --out <path> to wait and download the result into a file or folder. If you started a job without waiting, pick it up later with yesilcam wait <kind> <id>; the CLI prints the exact command when it returns a job. Assistants use wait=true and save_to, or the yesilcam_wait tool.

Image Studio

yesilcam image "a lighthouse at dusk, 35mm film" --tier draft --aspect 16:9 --yes --out lighthouse.png

Prompt: "Make a draft 16:9 image of a lighthouse at sunset. Tell me the price first, then save it to my desktop." The same tool edits an existing image, uses your saved characters and reference images, and accepts a negative prompt.

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

The first command only shows the price of a five-second draft clip. The second makes a video with two of your saved characters and stops at the first frame for your approval; the third approves it. For films from a story (Pro):

yesilcam film story "<your story>" --style anime --target-seconds 60 --yes --wait
yesilcam film produce <flow_id>

Story to Film builds a cast, storyboard and scenes first. You can edit scenes with yesilcam film scene before producing the film. Lip sync, voices, characters and Character Bible are in the same group (yesilcam video --help, yesilcam characters --help).

Animation Studio, Ink Landscape, Inkmation and 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 lists the 25 styles for free. Renders come out as MP4 (HD or 4K), WebP or GIF. Custom animates your own image along a camera path given as 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

Narration is saved to your library. Export, narration, a talking presenter from a photo and automatic subtitles are available; editing the timeline itself stays in the 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

Export formats are PNG, JPG, WebP, print PDF (CMYK, PDF/X), SVG and EPS. yesilcam design presets lists canvas sizes and styles for free.

Website Studio, Website Promo, Assemble / Disassemble

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

An Assemble / Disassemble video becomes the source of a scrolling product site. Website Promo works in two steps: first the script, which you can review and edit with yesilcam promo script, then the narrated video.

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

You can also import a garment from a product page with yesilcam fashion import <url>, show a look on another body type and, on Pro, turn a try-on into a 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 runs on your computer and is free. A plan from a photo or scan is charged by usage. Furnishing and landscape design need the 3D editor in the 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

The first command copies a ready-made influencer from Discover to your account; the others set its voice and language and make a scene video with a spoken line. To create your own, use yesilcam influencer create; with your own photo add --photo-path me.jpg --photo-consent (Basic or Pro). Long videos from 15 seconds to 10 minutes:

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

The plan gives you an editable storyboard and a quote, and the final length stays within ±5% of the target. You can save an edited storyboard with longvideo save --storyboard @sb.json and preview frames with longvideo frames before producing. Scheduled videos come from automations:

yesilcam automation save --influencer-id 70 --sector "specialty coffee" --days 1,4 --times 10:00 --timezone Europe/Istanbul --monthly-cap 1000000 --yes

Saving it authorises spending up to the monthly cap. Runs that wait for review are approved or skipped with automation review, and automation control pauses, resumes or deletes. Social publishing commands exist, but they report "coming soon" until publishing opens for your account; accounts are connected only in the web app.

Library and lineage

yesilcam library list --kind video --limit 3
yesilcam library upload ./photo.jpg --label "Product front"
yesilcam library lineage asset <id>

Lineage shows where a file came from and what was made from it. Prompt: "List the last three videos in my library, download the newest and tell me which job it came from."

Scripts and JSON

Put --json before the command (yesilcam --json image ...) for machine-readable output, and read ids from it rather than from the human-readable text. Check exit codes: 3 means a quote was shown and not approved, 2 means not signed in. Run jobs one after another when the order of their ids matters.

What stays in the web app?

Buying tokens or plans, billing, automatic top-ups for automations, connecting social accounts, creating and revoking API keys and deleting the account. Also Maket furnishing and landscape design, Cinema Studio timeline editing, browsing and liking on The Wall, and the image and video template galleries (templates can be used by id where noted).

Frequently asked

How do I find the options of a command? Add --help: yesilcam influencer video --help lists every option with its allowed values. The MCP server gives the assistant the same descriptions.

Where do results go? Into your library, as with the app, and to the path given with --out or save_to.

Can I pass long JSON values from a file? Yes. Options that take JSON accept @file.json, for example a storyboard or a camera path.