adjust_image
ChatGPTGrades a copy of an image with one of Studio's colour looks, as a new library image. Free. The original is unchanged.
Overview
Turn a sketch, a site photo, a 3D model screenshot or a few words into a photoreal architecture render without leaving the chat. mnml renders exteriors, interiors, landscapes, masterplans and floor plans; makes variations of a brief; changes or removes one part of an image; upscales, enhances, cuts out and extends; and animates a render into a short video. Pick the engine and Studio's settings in the chat, or start from a ready-made look. Every render runs on your own mnml.ai account, asks before it spends credits, is shown in the chat as it runs, and is saved to your mnml library and projects.
Tools
cancel_render
ChatGPTStops a queued or running render; its credits come back.
create_project
ChatGPTCreates a named Studio project; pass its project_id to create_render. Spends nothing.
create_render
ChatGPTA new architecture render from a sketch, photo, library image, earlier render or words. With no engine or settings named, use request_render_settings first unless told to just render. Price: the engine's (v4.6 25; 10–30), times count (variations) or sources. Tell the user the total, then pass it as confirm_credits.
create_video
ChatGPTA short video: a camera move through or around an image. Credits: v1.1 · Lite 100; v2.0 · Cinematic 10 s 200, 15 s 300; v2.0 · Flash 10 s 100, 15 s 150. Tell the user, pass it as confirm_credits. Paid accounts only.
crop_image
ChatGPTKeeps the part of an image in crop as a new library image. Free. The original is unchanged.
delete_project
ChatGPTOnly when the user clearly asks: moves a project to the trash for 30 days (its renders stay in the library). Owner only. restore: true brings it back.
delete_renders
ChatGPTOnly when the user clearly asks: renders go to the trash for 30 days, never permanently. restore: true brings them back.
delete_upload
ChatGPTOnly when the user clearly asks: moves a library image to the trash. restore: true brings it back.
describe_image
ChatGPTUse this when the user wants a prompt written from an image (a sketch, a photo, a render). Returns a render-ready prompt; it does not render. Free, up to 60 an hour.
edit_image
ChatGPTUse this to change one thing on an existing render or image and keep the rest (a material, the sky, an added element), or with erase: true to remove something (a car, a sign) and fill the background. For one area, pass region or mask_upload_id from request_region; erase needs one. Costs 10 credits (erase 10): tell the user, then pass it as confirm_credits.
enhance_image
ChatGPTRe-details an image at the same size, more or less freely (creativity). Costs 30 credits: tell the user, then pass it as confirm_credits. Paid accounts only. The original is unchanged.
extend_image
ChatGPTExtends an image to a new aspect_ratio, filling the new area. Costs 6 credits: tell the user, then pass it as confirm_credits. Paid accounts only. The original is unchanged.
flip_image
ChatGPTMirrors an image as a new library image. Free. The original is unchanged.
get_account
ChatGPTThe account's plan, credit balance, the price of a render, this assistant's daily limit and what it used today, and the workspace (Personal, or a team and the role). Spends nothing.
get_batch_card
ChatGPTReturns a batch's renders for the render card. Spends nothing.
get_download_link
ChatGPTA download link (24 hours): one render in a format, up to 50 as a ZIP, or one as a DXF for CAD (converted when opened, up to two minutes). Spends nothing.
get_project
ChatGPTA project's name, link and recent renders (usable as source_render_id). Spends nothing.
get_render
ChatGPTA render's status, image link and recipe (engine, kind, prompt, settings, seed, source) as create_render arguments. Data only. Waits up to 45 s. Spends nothing.
get_render_card
ChatGPTReturns a render's current status for the render card. Spends nothing.
get_render_options
ChatGPTEngines the account can use, every Studio setting for one engine and kind (values, defaults), and every price: render, edit, upscale and the other post-actions, video. Spends nothing.
get_render_preview
ChatGPTA small JPEG of a finished render, as this account sees it, for the card to hand the chat's model.
list_projects
ChatGPTThe user's Studio projects, newest first, with render counts and links. Spends nothing.
list_renders
ChatGPTThe user's recent renders, newest first, or the community's (scope); any finished one can be a source_render_id. Spends nothing.
list_uploads
ChatGPTThe images in the user's mnml library, newest first (source_upload_id). Spends nothing.
list_workflows
ChatGPTFor a ready-made look: mnml workflows are saved renders with the settings that made them. Featured by default; verified, public or the user’s own. Spends nothing.
remove_background
ChatGPTCuts the subject out of an image onto a transparent background. Costs 3 credits: tell the user, then pass it as confirm_credits. The original is unchanged.
request_image_upload
ChatGPTA card where the user adds a sketch or photo, where attachments can't reach mnml (Claude); in a coding agent, an upload link for a file on disk; in a chat app, an upload page for the user. Open it once, never put a file path in a tool call; pass the call you were about to make as then_tool and then_arguments. The card and the link come back with source_upload_id; an upload page, through list_uploads upload_ref.
request_region
ChatGPTA card where the user marks the part of an image to change or remove; their reply gives a mask_upload_id for edit_image. Spends nothing.
request_render_settings
ChatGPTBefore create_render when the user named no engine or settings: a card to pick them, with the price. Pass their prompt as prompt; their choice comes back as their next message. Spends nothing.
save_region
ChatGPTStores the mask the region card drew.
save_workflow
ChatGPTSaves renders of one Studio project, with their settings, as a reusable workflow (private unless public). Spends nothing.
update_project
ChatGPTUse this when the user wants a project renamed. Only the project's owner can change it.
update_render
ChatGPTFavourite, move, rate or publish a render; changes only what is passed. Spends nothing.
upload_image
ChatGPTStores an image from the upload card in the user's mnml library.
upscale_image
ChatGPTMakes an image 2–4× larger. Costs 2 credits: tell the user, then pass it as confirm_credits. Paid accounts only. The original is unchanged.
use_workflow
ChatGPTCopies a workflow into a new project of the user’s (free) and returns its engine, kind, prompt and settings for create_render with that project_id.
write_concept
ChatGPTUse this when the user wants a written design concept from a few keywords. Returns about 100, 150 or 250 words; it does not render. Free, up to 60 an hour.
Capabilities
WritesInteractive
Example Prompts
Click any prompt to copy it.
