Create renders from Spacely AI preset styles

Before

After - Moonless Night Style

Description

Transform your room images into beautifully designed spaces by selecting one of Spacely AI's preset styles. Ideal for instant redesigns and style visualizations.

Use cases

1. Visual style experimentation for client proposals.

2. Rapid concept generation for design projects.

Credit

1 successful Space Design API call = 1 credit.

API

POST https://api.spacely.ai/api/v1/generate/standard

This endpoint is used to standard generate

Headers

Name	Type	Description
X-API-KEY*	String

Request Body

Name	Type	Description
model*	String	The model name of the project. (e.g., "spacely-v1", "spacely-unfurnished-space", "spacely-style-transfer").
imageUrl*	String	The URL of the image representing the room or space to be designed/renovated. (e.g., "https://storage.googleapis.com/spacely/public/image/roomstyle3/bathroom-modern.jpg").
spaceType*	String	The type of the space (e.g., "bedroom", "living_room", "kitchen", etc.).
spaceStyle*	String	The style of the space (e.g., "modern", "minimalist", "industrial_loft", etc.).
spaceColor	String	The primary color theme or set used in the space (optional). (e.g., "set_1", "set_2", "set_3", etc.)
renovateType*	String	The type of renovation, whether "residential", "commercial" or "exterior"
styleUrl	String	The URL pointing to additional references or inspirations for the design
materialsIds	String[]	An array of material IDs representing the materials used in the project (e.g., "paper_wallpaper", "particle_board", "porcelain_tile", etc.).

200: OK Response ref Id for pulling data

{
  "data": REF_ID
}

400: Bad Request Not Found: Requested resource not found on the server.

401: Unauthorized The API key provided was invalid or missing.

500: Internal Server Error Unexpected condition on the server preventing request fulfillment.

Example

cURL

curl --location 'https://api.spacely.ai/api/v1/generate/standard' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "model": "spacely-v1",
    "imageUrl": IMAGE_URL,
    "spaceType": "bedroom",
    "spaceStyle": "modern",
    "spaceColor": "",
    "renovateType": "residential",
    "styleUrl": "",
    "materialsIds": [
        "paper_wallpaper",
        "particle_board",
        "porceline_tile"
    ]
}'

JavaScript

var myHeaders = new Headers();
myHeaders.append("X-API-KEY", YOUR_API_KEY);
myHeaders.append("Content-Type", "application/json");

var raw = JSON.stringify({
  "model": "spacely-v1",
  "imageUrl": IMAGE_URL,
  "spaceType": "bedroom",
  "spaceStyle": "modern",
  "spaceColor": "",
  "renovateType": "residential",
  "styleUrl": "",
  "materialsIds": [
    "paper_wallpaper",
    "particle_board",
    "porceline_tile"
  ]
});

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: raw,
  redirect: 'follow'
};

fetch("https://api.spacely.ai/api/v1/generate/standard", requestOptions)
  .then(response => response.text())
  .then(result => console.log(result))
  .catch(error => console.log('error', error));

NodeJs

const axios = require('axios');
let data = JSON.stringify({
  "model": "spacely-v1",
  "imageUrl": IMAGE_URL,
  "spaceType": "bedroom",
  "spaceStyle": "modern",
  "spaceColor": "",
  "renovateType": "residential",
  "styleUrl": "",
  "materialsIds": [
    "paper_wallpaper",
    "particle_board",
    "porceline_tile"
  ]
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.spacely.ai/api/v1/generate/standard',
  headers: { 
    'X-API-KEY': YOUR_API_KEY, 
    'Content-Type': 'application/json'
  },
  data : data
};

axios.request(config)
.then((response) => {
  console.log(JSON.stringify(response.data));
})
.catch((error) => {
  console.log(error);
});

Go

package main

import (
  "fmt"
  "strings"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://api.spacely.ai/api/v1/generate/standard"
  method := "POST"

  payload := strings.NewReader(`{
    "model": "spacely-v1",
    "imageUrl": IMAGE_URL
    "spaceType": "bedroom",
    "spaceStyle": "modern",
    "spaceColor": "",
    "renovateType": "residential",
    "styleUrl": "",
    "materialsIds": [
        "paper_wallpaper",
        "particle_board",
        "porceline_tile"
    ]
}`)

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("X-API-KEY", YOUR_API_KEY)
  req.Header.Add("Content-Type", "application/json")

  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Python

import requests
import json

url = "https://api.spacely.ai/api/v1/generate/standard"

payload = json.dumps({
  "model": "spacely-v1",
  "imageUrl": IMAGE_URL
  "spaceType": "bedroom",
  "spaceStyle": "modern",
  "spaceColor": "",
  "renovateType": "residential",
  "styleUrl": "",
  "materialsIds": [
    "paper_wallpaper",
    "particle_board",
    "porceline_tile"
  ]
})
headers = {
  'X-API-KEY': YOUR_API_KEY,
  'Content-Type': 'application/json'
}

response = requests.request("POST", url, headers=headers, data=payload)

print(response.text)

Tips and tricks

After receiving the response, use this api to retrieve the data.

Get Resources

Support

Any question? Contact us at [email protected]