Name: youzu Stable Interiors V2 Interior Design Image Generator API
Brand: magicapi
SKU: api-magicapi-interior-design-image-generator-youzu-stable-interiors-v2
Availability: InStock
Author: API Market

Shashank Agarwal

# 🏠 Interior Design Image Generator API (youzu Stable Interiors V2)

## Overview
Stable Interiors V2 is an interior design model published by youzu. Its developer describes it as an enhanced version of its earlier interior design model, with an improved diffusion model.

Send a photo of a room as `image` and describe the design you want in `prompt`. The model redraws the room following your description and returns the URL of one image.

## Features
- **Room photo in, redesigned room out**: the input `image` and the text `prompt` are both required.
- **Built-in negative prompt**: `negative_prompt` defaults to a list that steers away from watermarks, text, blur, distorted furniture, warped walls and similar artifacts. Send your own to replace it.
- **Prompt strength**: `prompt_strength` (default `0.8`) sets the strength of the prompt for inpainting.
- **Guidance scale**: `guidance_scale` (default `15`) sets how closely the result follows the prompt.
- **Denoising steps**: `num_inference_steps` (default `50`).
- **Seed**: set a seed to reproduce a result.

## Use Cases
1. **Interior design concepts**: show a client the same room in several styles (Scandinavian, industrial, mid-century) from one photo.
2. **Real estate listings**: virtually furnish empty or dated rooms for listing images.
3. **Furniture and decor retail**: mock up a room with a described set of furniture and materials.
4. **Renovation planning**: compare wall colors, lighting and layouts before any work starts.

## Visual Examples
### Example Input
Image:

![Example input: a photo of a room before redesign](https://blog.api.market/wp-content/uploads/2026/04/interior-input-api-market.jpg)

Prompt: "a fully furnished Scandinavian living room with one light wood coffee table, a neutral-toned fabric sofa on the left side of the wall, soft wool throws and cushions, white walls, minimalist shelving, a pendant lamp overhead, and minimal decor, with natural light streaming through sheer linen curtains"

Settings: `guidance_scale` `15`, `prompt_strength` `0.8`, `num_inference_steps` `50`, and the default `negative_prompt`.

### Example Output
![Stable Interiors V2 output: the room redesigned as a Scandinavian living room with a light wood coffee table, a fabric sofa, white walls and a pendant lamp](https://blog.api.market/wp-content/uploads/2026/11/stable-interiors-v2-output-ndgtdr3v-api-market.jpg)

## Input Parameters
| Field | Type | Required | Default | Allowed values | Description |
| --- | --- | --- | --- | --- | --- |
| `image` | string (URL) | Yes |  |  | Input room image URL |
| `prompt` | string | Yes |  |  | Text prompt for design |
| `negative_prompt` | string | No | `lowres, watermark, banner, logo, contactinfo, text, deformed, blurry, blur, out of focus, out of frame, surreal, extra limbs, extra furniture, ugly, overlapping objects, distorted furniture, impossible layout, broken geometry, unrealistic proportions, floating furniture, furniture merging with walls or windows, warped walls, curved walls, mirrors, mirrored surfaces, plush walls, fabric walls, soft focus, poor lighting, artifacts, cut-off furniture` |  | Negative prompt |
| `num_inference_steps` | integer | No | `50` |  | Number of denoising steps |
| `guidance_scale` | number | No | `15` |  | Guidance scale |
| `prompt_strength` | number | No | `0.8` |  | Prompt strength for inpainting |
| `seed` | integer | No | none |  | Random seed |

## Pricing
- **Pay As You Go (PAYG) pricing**: you only pay for what you use.
- **Price**: $0.015 per API unit.
- **1 API unit = 1 successful request with up to 13 seconds of processing.** A longer job bills one more unit for each started block of 13 seconds (for example, 20 seconds of processing is 2 units, $0.03).
- More `num_inference_steps` take longer to process.
- **Example cost**: the example request took 8.27 seconds of processing, which is 1 unit, so $0.015.
- **Failed or cancelled predictions are not billed.**
- **GET requests to check prediction status** are free and don't count toward API unit usage.
- **No monthly subscription fee.**

## API Documentation

### Base URL
All API requests go to: `https://prod.api.market/api/v1/magicapi/interior-design-image-generator-youzu-stable-interiors-v2`

### Authentication
Send your api.market API key in the `x-api-market-key` header:
```
x-api-market-key: YOUR_API_MARKET_KEY
```

### Asynchronous Processing
**IMPORTANT**: This API is asynchronous. The flow is:
1. Send a POST request to `/predictions`. A successful request returns **201 Created** with a prediction `id` and a `status` of `starting` or `processing`.
2. Poll GET `/predictions/{id}` with that ID.
3. Keep polling while `status` is `starting` or `processing`.
4. Stop when `status` is `succeeded` (read `output`), `failed` or `canceled` (read `error`).

A polling interval of 1 second and an overall timeout of 600 seconds (10 minutes) work well. The first request after a quiet period can wait a minute or more before processing starts; that waiting time is not billed.

### Endpoints

#### Create a Prediction
```bash
curl -X POST "https://prod.api.market/api/v1/magicapi/interior-design-image-generator-youzu-stable-interiors-v2/predictions" \
  -H "Content-Type: application/json" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY" \
  -d '{
    "version": "4836eb257a4fb8b87bac9eacbef9292ee8e1a497398ab96207067403a4be2daf",
    "input": {
      "image": "https://blog.api.market/wp-content/uploads/2026/04/interior-input-api-market.jpg",
      "prompt": "a fully furnished Scandinavian living room with one light wood coffee table, a neutral-toned fabric sofa on the left side of the wall, soft wool throws and cushions, white walls, minimalist shelving, a pendant lamp overhead, and minimal decor, with natural light streaming through sheer linen curtains",
      "guidance_scale": 15,
      "negative_prompt": "lowres, watermark, banner, logo, contactinfo, text, deformed, blurry, blur, out of focus, out of frame, surreal, extra limbs, extra furniture, ugly, overlapping objects, distorted furniture, impossible layout, broken geometry, unrealistic proportions, floating furniture, furniture merging with walls or windows, warped walls, curved walls, mirrors, mirrored surfaces, plush walls, fabric walls, soft focus, poor lighting, artifacts, cut-off furniture",
      "prompt_strength": 0.8,
      "num_inference_steps": 50
    }
  }'
```

Response (201 Created):
```json
{
  "id": "ndgtdr3vt5rmr0d1mvqtgvj2k0",
  "version": "4836eb257a4fb8b87bac9eacbef9292ee8e1a497398ab96207067403a4be2daf",
  "status": "starting",
  "created_at": "2026-11-04T14:21:15.089Z"
}
```

#### Check Prediction Status
```bash
curl -X GET "https://prod.api.market/api/v1/magicapi/interior-design-image-generator-youzu-stable-interiors-v2/predictions/{id}" \
  -H "x-api-market-key: YOUR_API_MARKET_KEY"
```

Response when the prediction has finished (200 OK):
```json
{
  "id": "ndgtdr3vt5rmr0d1mvqtgvj2k0",
  "status": "succeeded",
  "output": "https://blog.api.market/wp-content/uploads/2026/11/stable-interiors-v2-output-ndgtdr3v-api-market.jpg",
  "error": null,
  "created_at": "2026-11-04T14:21:15.089Z",
  "started_at": "2026-11-04T14:22:19.493Z",
  "completed_at": "2026-11-04T14:22:27.767Z"
}
```

`output` is a single URL string pointing to the generated image.

### Status Codes
- **201 Created**: prediction created (POST `/predictions`). This is the normal success response.
- **200 OK**: prediction details returned (GET `/predictions/{id}`).
- **400 Bad Request**: invalid input, for example a missing `image` or `prompt`.
- **401 Unauthorized**: missing or invalid API key.
- **404 Not Found**: no prediction with that ID.
- **429 Too Many Requests**: rate limit exceeded.
- **500 Internal Server Error** or **503 Service Unavailable**: temporary server problem; retry later.

## Rate Limits
Requests are rate limited to keep usage fair. If you receive a 429 response, wait and retry with exponential backoff.

## Error Handling
- Check the HTTP status code of every request and read the response body for the error message.
- A prediction can also end with `status` set to `failed`; the `error` field then explains why. Failed predictions are not billed.
- Retry 429, 500 and 503 responses with exponential backoff. Fix the input before retrying a 400.

## Implementation Guide
### Example Code

#### JavaScript
```javascript
const apiKey = "YOUR_API_MARKET_KEY";
const baseUrl = "https://prod.api.market/api/v1/magicapi/interior-design-image-generator-youzu-stable-interiors-v2";

async function createAndWaitForPrediction(input) {
  const response = await fetch(`${baseUrl}/predictions`, {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-market-key": apiKey
    },
    body: JSON.stringify({ version: "4836eb257a4fb8b87bac9eacbef9292ee8e1a497398ab96207067403a4be2daf", input })
  });

  if (response.status !== 201) {
    throw new Error(`API error: ${response.status} ${await response.text()}`);
  }

  const prediction = await response.json();
  return pollForResults(prediction.id);
}

const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));

async function pollForResults(predictionId) {
  const maxTimeout = 600000;
  const pollInterval = 1000;
  const startTime = Date.now();

  while (Date.now() - startTime < maxTimeout) {
    const response = await fetch(`${baseUrl}/predictions/${predictionId}`, {
      headers: { "x-api-market-key": apiKey }
    });

    if (!response.ok) {
      throw new Error(`API error: ${response.status} ${await response.text()}`);
    }

    const prediction = await response.json();

    if (prediction.status === "succeeded") {
      return prediction.output;
    }

    if (prediction.status === "failed" || prediction.status === "canceled") {
      throw new Error(`Prediction ${prediction.status}: ${prediction.error || "Unknown error"}`);
    }

    await delay(pollInterval);
  }

  throw new Error("Prediction timed out after 10 minutes");
}

createAndWaitForPrediction({
  "image": "https://blog.api.market/wp-content/uploads/2026/04/interior-input-api-market.jpg",
  "prompt": "a fully furnished Scandinavian living room with one light wood coffee table, a neutral-toned fabric sofa on the left side of the wall, soft wool throws and cushions, white walls, minimalist shelving, a pendant lamp overhead, and minimal decor, with natural light streaming through sheer linen curtains",
  "guidance_scale": 15,
  "negative_prompt": "lowres, watermark, banner, logo, contactinfo, text, deformed, blurry, blur, out of focus, out of frame, surreal, extra limbs, extra furniture, ugly, overlapping objects, distorted furniture, impossible layout, broken geometry, unrealistic proportions, floating furniture, furniture merging with walls or windows, warped walls, curved walls, mirrors, mirrored surfaces, plush walls, fabric walls, soft focus, poor lighting, artifacts, cut-off furniture",
  "prompt_strength": 0.8,
  "num_inference_steps": 50
}).then((output) => console.log(output));
```

#### Python
```python
import time
import requests

API_KEY = "YOUR_API_MARKET_KEY"
BASE_URL = "https://prod.api.market/api/v1/magicapi/interior-design-image-generator-youzu-stable-interiors-v2"


def create_and_wait_for_prediction(input_data):
    headers = {"Content-Type": "application/json", "x-api-market-key": API_KEY}
    response = requests.post(
        f"{BASE_URL}/predictions",
        headers=headers,
        json={"version": "4836eb257a4fb8b87bac9eacbef9292ee8e1a497398ab96207067403a4be2daf", "input": input_data},
    )

    if response.status_code != 201:
        raise Exception(f"API error: {response.status_code} {response.text}")

    return poll_for_results(response.json()["id"])


def poll_for_results(prediction_id):
    max_timeout = 600
    poll_interval = 1
    headers = {"x-api-market-key": API_KEY}
    start_time = time.time()

    while time.time() - start_time < max_timeout:
        response = requests.get(f"{BASE_URL}/predictions/{prediction_id}", headers=headers)

        if response.status_code != 200:
            raise Exception(f"API error: {response.status_code} {response.text}")

        prediction = response.json()

        if prediction["status"] == "succeeded":
            return prediction["output"]

        if prediction["status"] in ("failed", "canceled"):
            raise Exception(f"Prediction {prediction['status']}: {prediction.get('error') or 'Unknown error'}")

        time.sleep(poll_interval)

    raise Exception("Prediction timed out after 10 minutes")


print(create_and_wait_for_prediction({
    "image": "https://blog.api.market/wp-content/uploads/2026/04/interior-input-api-market.jpg",
    "prompt": "a fully furnished Scandinavian living room with one light wood coffee table, a neutral-toned fabric sofa on the left side of the wall, soft wool throws and cushions, white walls, minimalist shelving, a pendant lamp overhead, and minimal decor, with natural light streaming through sheer linen curtains",
    "guidance_scale": 15,
    "negative_prompt": "lowres, watermark, banner, logo, contactinfo, text, deformed, blurry, blur, out of focus, out of frame, surreal, extra limbs, extra furniture, ugly, overlapping objects, distorted furniture, impossible layout, broken geometry, unrealistic proportions, floating furniture, furniture merging with walls or windows, warped walls, curved walls, mirrors, mirrored surfaces, plush walls, fabric walls, soft focus, poor lighting, artifacts, cut-off furniture",
    "prompt_strength": 0.8,
    "num_inference_steps": 50
}))
```

## FAQ
- **Can I generate a room without an input photo?**
  - No. Both `image` and `prompt` are required; the model redesigns the room in the photo you send.
- **Do I need to send the long negative prompt?**
  - No. It is the default `negative_prompt`; the example sends it explicitly only to show it. Send your own value to replace it.
- **How much does one image cost?**
  - $0.015 for each started block of 13 seconds of processing. The example at 50 steps took 8.27 seconds, so it cost 1 unit ($0.015).
- **How do I get the same result again?**
  - Send the same input with the same `seed`.
- **What if my prediction fails?**
  - Failed predictions are not billed. Read the `error` field, adjust the input and try again.

## Contact Us
If you have any questions, reach out to us through the chat on the bottom right of the page.


Send a room photo and a design prompt to get the room redesigned in that style with Stable Interiors V2. $0.015 per request of up to 13 seconds of processing, pay as you go.