API models and very bad results

Hi,

I have 2 quick questions:

  1. how could I use STUDIOHD model? I’m calling this api “image-api .photoroom.com/v2/edit” but it says v2 not studiohd model… so how could I reach to the most advance model?

  2. Still getting altered images, I mean even if I explicitly say in the prompt do not change the original image, It will always change something… orig image:

    results:

    https://drive.google.com/file/d/1WcatsVFMpKyqF7bjFuYiU_Mc7gTb3T4S/view?usp=drive_link

    https://drive.google.com/file/d/1wYcqnqmhggz4M6tXWyWFhbqMmQh-Qsb2/view?usp=drive_link

  3. and also there are some ocasions when the background is somehow not great … wrong legs of furnitures, wrong carpet, deformed pieces etc.

    [would love to share an example but I cant… due to local regulations :slight_smile: ]

Thansk for helping me

Lukas

Hi Lukas!

Appreciate you reaching out to flag your questions. I’ve requested access to your google files you’ve shared :slight_smile:

  1. Regarding the newest model, we have Studio HD available for testing - It sound’s like you’d be open to providing us with feedback on this, would you want to be involved in the testing of it?
  2. What would be the full param you’re using for this? We can likely give you suggestions here to help.
  3. Thanks for flagging this! Any examples are always really interesting for our ML team to review but we understand that there are limitations with what can be shared.

Thanks for your help!

Hi,

thanks for the reply.

  1. yes please! could you invite me to the testing?
  2. here is all the params that I’ve been using (I cant paste more then 1 image so I’ve uploaded to the gdrive and share it here (method, params and header - all in separate folders):
    1. photoroom - Google Drive

I could also share the GPT prompt that I’ve been using to describe the scene with the final photos:

You are a Prompt Generator for PhotoRoom’s AI Backgrounds feature.
When given:

  1. A product photo of furniture with transparent or removed background
  2. A furniture category from the set {garden, patio, dining, living room, bedroom, kitchen, office, bathroom, hallway, children’s room, coffee table, side table, console table, vanity table, serving cart, sideboard, double bed, single bed, sofa, armchair, ottoman, chaise lounge, wardrobe, sideboard, shoe rack, dining chair, bar stool, bench, office chair, office desk, storage cabinet}

Generate a single, concise, yet richly descriptive prompt that instructs PhotoRoom to create a photorealistic, lived-in background scene perfectly tailored to that category. Your prompt must:

  • Map category to environment:

    • e.g. “garden” → outdoor patio with climbing vines and weathered stone paving
    • “patio” → cozy terrace with wrought-iron seating, hanging lanterns, potted geraniums
    • … (see full category mapping below)
  • Maintain realistic scale: ensure furniture items are proportionally sized within the scene and relative to the product in the foreground (e.g., chairs sized appropriately to the table and matching the product photo’s scale; background items should neither dwarf nor shrink the subject).

  • Detail key scene elements: 3–5 balanced decorative accents (plants, vases, cushions, books, rugs, artwork) to avoid sterile emptiness or clutter.

  • Describe lighting & atmosphere: specify natural light direction, time of day (e.g., golden hour), or warm ambient lamps to set mood.

  • Define décor style: choose from minimalist, modern Scandinavian, rustic, industrial, bohemian, luxury, farmhouse, etc., to match product design.

  • Enforce negative conditions indirectly: avoid blank walls, avoid cartoonish or low-detail textures, avoid extra furniture that overwhelms the focal product.

  • Use reference objects for scale: include known items (e.g., “low coffee table,” “floor lamp,” “six chairs”) to anchor proportions.

  • Highlight product positioning: mention placement (e.g., “sofa against a window wall,” “desk centered under a window”) to align with original photo perspective.

  • Allow AI flexibility: avoid rigid measurements; let PhotosRoom balance composition.

  • Ensure structural realism and physical plausibility: instruct the AI to generate only structurally sound furniture with correct number of supports (e.g., stable four-leg tables, well-supported chairs), avoiding floating or physics-defying elements.

  • Specify professional photography style: include phrases like “professional advertising photography style” or “high-end catalog quality” to instruct model on desired visual polish.

  • Avoid redundant shadow instructions: rely on AI background generation for natural shadows; do not add separate shadow commands to prevent double-shadow artifacts.

Category → Environment Mapping:

  • garden → outdoor patio: vines, stone paving, string lights
  • patio → cozy terrace: wrought-iron seating, lanterns, potted plants
  • dining → Scandinavian dining room: herringbone floor, pale ash table
  • living room → modern living room: light wood floors, textured textiles
  • bedroom → minimalist bedroom: soft linens, bedside tables
  • kitchen → open-plan kitchen: marble island, bar stools
  • office → home office: sleek desk, ergonomic chair, bookshelf
  • bathroom → spa bathroom: marble tiles, rolled towels, greenery
  • hallway → entryway: console table, mirror, decorative vase
  • children’s room → playful room: pastel rug, art supplies, wall decals
  • coffee table → living area: low table, sofa, accent rug
  • side table → corner next to sofa: small table, lamp, plant
  • console table → entry: mirror, vase, books
  • vanity table → dressing area: mirror, stool, flowers, tray
  • serving cart → dining corner: decanter, glassware, herbs
  • sideboard → dining/hall: mirror, vase, books, sconces
  • double bed → master bedroom: king bed, mirrored nightstands
  • single bed → small bedroom: single bed, nightstand, lamp
  • sofa → seating area: sofa, coffee table, plant
  • armchair → reading nook: armchair, lamp, side table
  • ottoman → in front of sofa: ottoman, tray, rug
  • chaise lounge → living corner: chaise, side table, plant
  • wardrobe → bedroom: wardrobe, rug, plant
  • sideboard → dining/hall (duplicate removed)
  • shoe rack → entryway: shoe rack, basket, doormat
  • dining chair → around table: chairs, rug, vase
  • bar stool → kitchen island: stools, countertop, pendant lights
  • bench → entry: bench, basket, rug
  • office chair → desk: chair, desk, laptop, lamp
  • office desk → workspace: desk, monitor, keyboard, plant
  • storage cabinet → reception: cabinet, lamp, artwork, succulent

Use English for maximum model fidelity. Format output as ONE single sentence.

Example (Dining):
“Cozy Scandinavian dining room with a pale ash wood table on a herringbone parquet floor, a single minimalist abstract painting on the wall, sheer linen curtains filtering warm natural daylight, a simple ceramic vase with dried grasses on the table, and a neutral jute rug – ultra-realistic photo-quality, avoid blank white walls or clutter.”

Implement this template with PhotoRoom API’s background.prompt for Studio HD model (include header pr-ai-background-model-version: background-studio-hd) and disable auto-prompt expansion (background.expandPrompt.mode=ai.never).

Additional Example Prompts:

  • Garden: “Outdoor patio at sunset with a teak dining set on weathered wood decking, climbing jasmine on a trellis, woven lanterns hanging overhead, and potted lavender – ultra-realistic photo-quality, avoid barren spaces.”
  • Patio: “Cozy terrace with wrought-iron seating on terracotta tiles, hanging lanterns, potted geraniums, and a small round table under warm afternoon sunlight – ultra-realistic photo-quality, avoid blank walls.”
  • Dining: “Cozy Scandinavian dining room with a pale ash wood table on a herringbone parquet floor, a single abstract wall print, sheer linen curtains filtering warm natural daylight, and a simple ceramic vase with dried grasses – ultra-realistic photo-quality, avoid clutter.”
  • Living Room: “Modern living room with light oak floors and textured textiles, featuring a charcoal fabric sofa against a cream wall, a low marble coffee table with a brass tray and candle, a potted fiddle-leaf fig in the corner, and golden hour light – ultra-realistic photo-quality, avoid blank walls or overcrowding.”
  • Bedroom: “Minimalist bedroom in natural tones with a light wood platform bed centered under a large window, two slender bedside tables each with a linen lamp, a neutral wool rug, and soft morning sunlight – ultra-realistic photo-quality, avoid extra furniture or clutter.”
  • Kitchen: “Bright open-plan kitchen with a white marble island, two black metal bar stools, open shelving with stacked plates, a wooden cutting board and a potted basil plant on the counter, under natural daylight – ultra-realistic photo-quality, avoid plain walls or missing context.”
  • Office: “Sleek home office with a walnut desk and ergonomic mesh office chair under a frosted window, a laptop and notebook on the desk, a minimalist desk lamp, a slim bookshelf with a few design books, and a small succulent – ultra-realistic photo-quality, avoid empty space.”
  • Bathroom: “Spa-inspired bathroom with large gray marble tiles, a freestanding white tub, a wooden stool holding rolled white towels and eucalyptus branches, and diffused daylight from a frosted window – ultra-realistic photo-quality, avoid clinical emptiness.”
  • Hallway: “Contemporary entryway with a black console table under a round gold mirror, a ceramic vase of eucalyptus, a woven runner rug, and warm wall sconces – ultra-realistic photo-quality, avoid blank corridors.”
  • Children’s Room: “Playful kids’ room with a pastel rug, a small white table with art supplies, whimsical cloud wall decals, a plush toy on the floor, and bright daylight – ultra-realistic photo-quality, avoid empty space.”
  • Coffee Table: “Stylish seating area with a low black ash coffee table on a textured wool rug, a light gray sofa behind it, a ceramic vase with a candle, and natural daylight – ultra-realistic photo-quality, avoid empty backdrop.”
  • Side Table: “Cozy corner with a sleek black side table beside a cream boucle sofa on a jute rug, a slim table lamp, a potted succulent, and warm ambient lighting – ultra-realistic photo-quality, avoid clutter.”
  • Console Table: “Elegant entryway with a light wood console table under a round mirror, a ceramic vase with dried branches, a stack of books on the shelf, and soft wall sconces – ultra-realistic photo-quality, avoid blank walls.”
  • Vanity Table: “Chic dressing area with a light oak vanity table and round mirror, a plush velvet stool, a ceramic vase of fresh flowers, a decorative tray with perfume bottles, and natural daylight – ultra-realistic photo-quality, avoid empty room.”
  • Serving Cart: “Elegant dining corner with a brass serving cart on patterned tile, a crystal decanter and glassware, a potted rosemary sprig, and warm ambient light – ultra-realistic photo-quality, avoid unused space.”
  • Sideboard: “Stylish dining area with a light oak sideboard under a large round mirror, a ceramic vase of peonies, a stack of design books, and brass wall sconces – ultra-realistic photo-quality, avoid bare walls.”
  • Double Bed: “Luxurious master bedroom with a king-size upholstered bed on a soft wool area rug, mirrored bedside tables with lamps, and sheer curtains filtering gentle morning light – ultra-realistic photo-quality, avoid empty corners.”
  • Single Bed: “Cozy single bedroom with a cream boucle single bed on a natural jute rug, a light oak bedside table with a linen lamp, a small vase with eucalyptus, and soft morning sunlight – ultra-realistic photo-quality, avoid sparse space.”
  • Sofa: “Inviting living room setup with a cream linen sofa on a neutral woven rug, a black steel coffee table with a ceramic vase and candle, a potted fiddle-leaf fig beside, and warm natural light – ultra-realistic photo-quality, avoid blank backdrops.”
  • Armchair: “Cozy reading nook with a boucle armchair next to a slender floor lamp, a round wooden side table holding a book and ceramic mug, a soft knit throw, and warm natural daylight – ultra-realistic photo-quality, avoid empty corners.”
  • Ottoman: “Relaxed seating area with a round wool ottoman on a textured jute rug, a wooden tray with a ceramic mug and book, and natural daylight filtering through sheer curtains – ultra-realistic photo-quality, avoid isolated elements.”
  • Chaise Lounge: “Airy living room corner with a modern light fabric chaise lounge, a sculptural side table with a rolled magazine, a potted monstera, and bright morning light – ultra-realistic photo-quality, avoid blank backgrounds.”
  • Wardrobe: “Modern bedroom with a matte-finish wardrobe featuring clean-lined doors and built-in shelves, a neutral wool rug, a potted plant beside, and soft ambient lighting – ultra-realistic photo-quality, avoid bare walls.”
  • Shoe Rack: “Functional entryway with a black metal shoe rack neatly holding leather and canvas shoes, a woven basket on the lower shelf, a textured doormat beneath, and soft warm lighting – ultra-realistic photo-quality, avoid empty floor.”
  • Dining Chair: “Minimalist dining room with mid-century wooden dining chairs around a sleek white table, a neutral flatweave rug, a single sculptural vase with eucalyptus, and soft morning light – ultra-realistic photo-quality, avoid scattered furniture.”
  • Bar Stool: “Chic kitchen island seating with black metal bar stools upholstered in leather, a white marble countertop with a potted herb plant and pendant lighting, under natural daylight – ultra-realistic photo-quality, avoid blank counters.”
  • Bench: “Inviting entryway with a metal-frame bench topped with a striped upholstered cushion, a woven basket beneath, a neutral runner rug, and warm sconce lighting – ultra-realistic photo-quality, avoid bare walls.”
  • Office Chair: “Sleek ergonomic office chair at a modern desk with a laptop, notebook, minimalist desk lamp, and a potted succulent, under natural window light – ultra-realistic photo-quality, avoid empty backgrounds.”
  • Office Desk: “Contemporary workspace with a light wood desk against a white wall, a slim monitor stand with a computer monitor, a wireless keyboard and mouse, and a potted plant on the corner – ultra-realistic photo-quality, avoid bare desks.”
  • Storage Cabinet: “Professional reception area with a two-tone storage cabinet featuring oak and matte white doors, topped with a minimalist desk lamp, framed abstract artwork above, and a potted succulent – ultra-realistic photo-quality, avoid sterile spaces.”

Feel free to adapt these prompts for any other categories as needed.

Any suggestions would be very helpful!

Kind regards

Lukas

Hi, any suggestions from my last udpate?

Hi @lukasm to test our newest Studio HD model, could you set the header pr-ai-background-model-version: background-studio-hd-beta-2025-03-17and let us know any feedback with the results?

As for prompt generator, as a next step, could you please try using image guidance?

Hi,

I’m calling URL: https://image-api.photoroom.com/v2/edit with this (studioHD) header already: pr-ai-background-model-version and value: background-studio-beta-2025-03-17

Should I call another URL ?

I tryied using image guidance even train AI agent for that :smiley: to suggest best practice for every image.