Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
LUW_API_KEYNoYour API key (get one at https://app.luw.ai/dashboard/api). Required. LUW_API_TOKEN also works.
LUW_TOOLSETSNoComma-separated list from generate, archigpt, personas, projects, team, or all.all except team
LUW_API_TOKENNoAlternative to LUW_API_KEY; also works for authentication.
LUW_OUTPUT_DIRNoAlso download results (images, videos, GLB, SVG) into this folder.
LUW_API_BASE_URLNoAPI endpoint override.https://api.luw.ai/v2
LUW_INLINE_IMAGESNoEmbed result images in tool output.true
LUW_WAIT_TIMEOUT_SECONDSNoHow long a call waits before returning a processing_url. Raise it for clients with long tool timeouts, such as Claude Code.50

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Luw.ai: AI tools for interior, exterior and landscape design, architectural rendering, image editing, video and 3D. Image inputs accept https:// URLs, local file paths or data: URIs; local files are uploaded to Luw.ai automatically. Generations wait up to 50s. A tool that returns a processing_url is still running; luw_get_result collects it and can be called again while it runs. Running the generation again would use credits twice. Each generation uses credits from the user's Luw.ai account; variations multiply the cost. luw_list_options lists valid style, room type, camera motion and material names. To change one exact area, luw_segment returns a mask for luw_magic_wand or luw_landscape_design. Everything these tools make is an AI-generated concept, not for construction or renovation. When the user means to build or renovate from it, tell them once, in their language, that a licensed architect or engineer must turn it into a real project and the local authority must approve it and issue permits; never say whether a real wall, column or beam can be removed, and never call a design structurally sound, code-compliant or permit-ready. Without an API key, calls fail with setup steps; keys are created at https://app.luw.ai/dashboard/api.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
logging
{}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}
completions
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
luw_interior_designA

Luw.ai Interior AI: redesign an interior photo — home, office, shop, hotel — in any style while keeping the room's architecture. Restyles furniture, materials, colors and lighting. Set empty_room=true to furnish an empty room or turn it into another room type (virtual staging). Costs 1 credit per variation.

luw_exterior_designA

Luw.ai Exterior AI: redesign a building exterior or facade photo — houses, villas, apartments, commercial buildings — in a new architectural style, with new materials, colors and landscaping, keeping the structure. Costs 1 credit per variation.

luw_sketch_to_renderA

Luw.ai Sketch AI: turn a hand sketch, line drawing, floor-plan perspective or rough draft into a photorealistic render. Costs 1 credit per variation.

luw_renderB

Luw.ai Render AI: turn a 3D model view, CAD/BIM screenshot, clay render or basic visualization into a photorealistic architectural render. Costs 1 credit per variation.

luw_edit_imageA

Luw.ai Magic Prompt AI: edit any image with a plain-language instruction: "make the sofa green velvet", "add a pendant lamp over the table", "turn it into a night scene". Pass products, materials or a mood board as reference_images to place or apply them. For edits restricted to an exact area, use luw_magic_wand. Costs 1 credit per variation (2 at 4k).

luw_magic_wandA

Luw.ai Magic Wand AI: change only a masked area of an image. Give a prompt to add/replace what's there, remove=true to erase it, or material_image to re-surface it (e.g. new flooring or wall tiles). The mask is a black-and-white image the same size as the input; white marks the area to change. Get masks from luw_segment. Costs 1 credit.

luw_landscape_designA

Luw.ai Landscape AI: design a garden, yard or outdoor area inside a masked region of a photo, with plants chosen for the location's climate and sun exposure. Costs 1 credit.

luw_upscale_imageA

Luw.ai Photo Enhance AI: enhance the quality of an image and enlarge it 2x, 3x or 4x (8x is sent as 4x). Costs 1 credit.

luw_expand_imageA

Luw.ai Expand AI: outpaint a tightly cropped architectural or interior photo to a wider view. Costs 1 credit.

luw_remove_furnitureA

Luw.ai Remove Furniture AI: remove the furniture from a room photo, keeping walls, floor and windows. Costs 1 credit.

luw_vectorize_imageA

Luw.ai Vector AI: convert a photo or drawing into a clean SVG vector. Costs 1 credit.

luw_backgroundA

Luw.ai Change Background: cut out a product/object from its background (transparent PNG) — or, with a prompt, place it in a new generated scene for marketing shots ("on a marble kitchen counter, morning light"). Omit prompt to just remove the background. Costs 1 credit.

luw_segmentA

Luw.ai Segment AI: detect objects in a photo and return black-and-white masks as image URLs — every object (wall, floor, sofa, …) or only what you describe in prompt. Feed a mask URL into luw_magic_wand or luw_landscape_design to edit exactly that area. Costs 1 credit.

luw_generate_imageA

Luw.ai Fluw AI: generate a photorealistic image or illustration from a text prompt (optionally guided by an input image) — concept art, interiors, products, marketing visuals. Set format="svg" for a vector illustration (Fluw Vector AI). Costs 2 credits per image.

luw_generate_patternA

Luw.ai Pattern AI: generate a seamless, tileable pattern or texture — tiles, wallpaper, fabric, terrazzo, wood, stone — ready to repeat across a surface. Costs 1 credit.

luw_generate_videoA

Luw.ai Video AI (Motion): animate a design image into a short cinematic video — fly-throughs, dolly moves, drone shots, reveals. Camera motions: A Forward Dolly, Flythrough Cinematic, Return to Empty Room, Lighting and Color Details, Drone flying to center, Dramatic Zoom Out, Reverse Zoom In, Slow Pull Back, Reveal Zoom, Ground to Sky Tilt, Side Tracking Zoom, Aerial Descent. Pass end_image to make the video end on that frame, e.g. the original photo as image and its redesign as end_image for a before → after transition. Takes a few minutes — expect a processing_url to collect with luw_get_result. Costs 10 credits (aria) or 20 (symphony), with or without end_image.

luw_image_to_3dA

Luw.ai 3DGen AI: generate a textured 3D model (GLB) from a photo of an object — furniture, decor, products. Add up to 3 photos from other angles for better accuracy. For text-to-3D, first make an image with luw_generate_image. Costs 3 credits (aria) or 8 (symphony, which adds a high-detail texture pack on paid accounts).

luw_get_resultA

Collect the result of a Luw.ai generation that was still processing (tools return a processing_url when a job outlasts their wait). Waits for the job to finish (up to the server's wait limit) — call again if it's still running. Free; never re-run a generation instead.

luw_upload_fileA

Upload an image, video or 3D file to Luw.ai storage and get a URL usable by every Luw.ai tool. Rarely needed: all tools already accept local paths and data: URIs and upload them automatically. Useful to get a shareable URL, to re-host an image from a site Luw.ai can't reach, or to store a file permanently.

luw_list_optionsA

Look up valid values for other Luw.ai tools: design_styles (styles param), interior_types (room_type), exterior_types (building_type), video_styles (camera_motion), materials (Magic Wand material_image catalog), professions (persona profession). Free.

luw_run_modelA

Call POST /generate with raw API parameters, for models or options the dedicated tools don't cover (e.g. persona-slot inputs, webhooks). Models: interior, exterior, sketch, render, magicprompt, magicwand, moodboard, landscape, enhance, expand, vector, removefurniture, segment, segmentprompt, fluw, fluwvector, pattern, changebg, removebg, video, 3dgen. Parameter reference: https://luw-ai.gitbook.io/api. Image fields (image, end_image, mask_image, material_image, style_transfer, extra_image_1…6) also accept local paths and data: URIs. Spends credits like the model's own tool.

luw_archigptA

Ask Luw.ai's ArchiGPT, an AI architect: design advice, feng shui, space planning, material and color suggestions, technical questions, and estimating square meters from a photo or plan. Attach an image to discuss it. Each call is a standalone question, so put the details it depends on into the message. Costs 1 credit per ~3000 words.

luw_personasA

Personas hold a reusable design identity: style knowledge plus saved images (trainings). Slots 1-6 train the persona's visual style (slot 1 is the style-transfer reference used by style_reference="persona"), slot 7 is the default input image, 8+ are free-form data; add_training without a slot "likes" a design. Pass persona_id to generation tools to use one. Actions: list, get, create, update, delete, list_trainings, add_training, update_training, delete_training, clear_slot.

luw_projectsB

Organize work in Luw.ai projects (called boards in the API), with nested folders and media. Use add_media to save generated results into a project. Actions: list, get, create, rename, delete, list_folders, create_folder, update_folder, delete_folder, add_media, delete_media, move_media.

Prompts

Interactive templates invoked by user choice

NameDescription
redesign_roomRestyle a room photo in a chosen design style (2 variations).
stage_empty_roomFurnish an empty room photo for a listing.
sketch_to_renderTurn a sketch or drawing into a photorealistic render.
product_shotPut a product photo into a new generated scene.

Resources

Contextual data attached and managed by the client

NameDescription
accountYour Luw.ai credit balance.
guideWhat each Luw.ai tool does and what it costs in credits.
Design stylesValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
Room typesValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
Building typesValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
Video camera motionsValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
MaterialsValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
Persona professionsValid design styles, room and building types, video camera motions, materials and persona professions, with previews.
Interior historyYour latest Interior projects and results.
Exterior historyYour latest Exterior projects and results.
Sketch historyYour latest Sketch projects and results.
Render historyYour latest Render projects and results.
MagicPrompt historyYour latest MagicPrompt projects and results.
MagicWand historyYour latest MagicWand projects and results.
Landscape historyYour latest Landscape projects and results.
Enhance historyYour latest Enhance projects and results.
Expand historyYour latest Expand projects and results.
RemoveFurniture historyYour latest RemoveFurniture projects and results.
Vector historyYour latest Vector projects and results.
ChangeBG historyYour latest ChangeBG projects and results.
Fluw historyYour latest Fluw projects and results.
Pattern historyYour latest Pattern projects and results.
MoodBoard historyYour latest MoodBoard projects and results.
Video historyYour latest Video projects and results.
3DGen historyYour latest 3DGen projects and results.

TDQS

A3.7/5.0

Scored across 24 tools

Disambiguation4/5

Each generation tool maps to a distinct model and input type (exterior vs interior vs sketch vs render vs landscape), and the mask-based tools are separated from the prompt-based ones by explicit description cues. The main soft spots are luw_run_model acting as a raw escape hatch over every other generation tool, and the border between luw_edit_image and luw_magic_wand, which only the descriptions disambiguate.

Naming Consistency4/5

A uniform luw_ prefix plus largely verb_noun names (edit_image, upscale_image, remove_furniture, generate_video, get_result) keeps the set readable and predictable. Deviations are noun-only names matching product brands (luw_archigpt, luw_magic_wand, luw_personas, luw_projects, luw_background), and multi-action tools (personas, projects) fold their verbs into parameters instead of names.

Tool Count3/5

At 24 tools the surface is heavy, and several entries are largely redundant: luw_vectorize_image duplicates luw_generate_image with format="svg", luw_remove_furniture is a special case of masked editing, and luw_run_model subsumes the whole generation set. Each still maps to a real backend model, so the count is defensible but sits at the top of a comfortable range.

Completeness5/5

The lifecycle is well covered: generation (interior/exterior/sketch/render/landscape/pattern/video/3D), editing (edit, magic wand, expand, upscale, background, segment), async collection via luw_get_result, file upload, option lookup, plus personas and projects for reusable identities and saved media. luw_run_model closes any remaining model or parameter gap, leaving only minor omissions like a credits/balance check.

Maintenance

ActivityActive
ResponsivenessLimited data