Decoration placement

Description

Add your decoration into the existing room. Spacely AI furniture placement AI will place the furniture into the room, making it smooth, seamless, and realistic. This API is better for a high detail decoration.

Use cases

Visual style experimentation for client proposals.
Rapid concept generation for design projects.

Credit

1 successful decoration placement API call = 1 credit.

API

POST https://api.spacely.ai/api/v1/generate/decoration-placement

This endpoint is used to standard generate

Headers

Request Body

{
  "data": REF_ID
}

Example

curl --location 'https://api.spacely.ai/api/v1/generate/decoration-placement' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "imageUrl": IMAGE_URL,
    "productImageUrl": IMAGE_URL,
    "productWidth": 100.1,
    "productHeight": 120.1,
    "referenceLine": [
        {
            "x": 361.1,
            "y": 424.1
        },
        {
            "x": 361.1,
            "y": 289.1
        }
    ],
    "lineLength": 100.1,
    "placement": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    },
    "isRemove": true,
    "removeArea": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    }
}'


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

const raw = JSON.stringify({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": true,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

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

const axios = require('axios');
let data = JSON.stringify({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": true,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.spacely.ai/api/v1/generate/decoration-placement',
  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);
});

package main

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

func main() {

  url := "https://api.spacely.ai/api/v1/generate/decoration-placement"
  method := "POST"

  payload := strings.NewReader(`{
    "imageUrl": IMAGE_URL,
    "productImageUrl": IMAGE_URL,
    "productWidth": 100.1,
    "productHeight": 120.1,
    "referenceLine": [
        {
            "x": 361.1,
            "y": 424.1
        },
        {
            "x": 361.1,
            "y": 289.1
        }
    ],
    "lineLength": 100.1,
    "placement": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    },
    "isRemove": true,
    "removeArea": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    }
}`)

  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))
}

import requests
import json

url = "https://api.spacely.ai/api/v1/generate/decoration-placement"

payload = json.dumps({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": True,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
})
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.

Support

Any question? Contact us at support@spacely.ai

PreviousFurniture placement NextColor transfer

Last updated 7 months ago

API

POST https://api.spacely.ai/api/v1/generate/decoration-placement

This endpoint is used to standard generate

Headers

Name

Type

Description

Request Body

Name

Type

Description

{
  "data": REF_ID
}

Example

curl --location 'https://api.spacely.ai/api/v1/generate/decoration-placement' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "imageUrl": IMAGE_URL,
    "productImageUrl": IMAGE_URL,
    "productWidth": 100.1,
    "productHeight": 120.1,
    "referenceLine": [
        {
            "x": 361.1,
            "y": 424.1
        },
        {
            "x": 361.1,
            "y": 289.1
        }
    ],
    "lineLength": 100.1,
    "placement": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    },
    "isRemove": true,
    "removeArea": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    }
}'


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

const raw = JSON.stringify({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": true,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
});

const requestOptions = {
  method: "POST",
  headers: myHeaders,
  body: raw,
  redirect: "follow"
};

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

const axios = require('axios');
let data = JSON.stringify({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": true,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
});

let config = {
  method: 'post',
  maxBodyLength: Infinity,
  url: 'https://api.spacely.ai/api/v1/generate/decoration-placement',
  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);
});

package main

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

func main() {

  url := "https://api.spacely.ai/api/v1/generate/decoration-placement"
  method := "POST"

  payload := strings.NewReader(`{
    "imageUrl": IMAGE_URL,
    "productImageUrl": IMAGE_URL,
    "productWidth": 100.1,
    "productHeight": 120.1,
    "referenceLine": [
        {
            "x": 361.1,
            "y": 424.1
        },
        {
            "x": 361.1,
            "y": 289.1
        }
    ],
    "lineLength": 100.1,
    "placement": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    },
    "isRemove": true,
    "removeArea": {
        "x": 85.1,
        "y": 0.1,
        "w": 90.1,
        "h": 250.1
    }
}`)

  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))
}

import requests
import json

url = "https://api.spacely.ai/api/v1/generate/decoration-placement"

payload = json.dumps({
  "imageUrl": IMAGE_URL,
  "productImageUrl": IMAGE_URL,
  "productWidth": 100.1,
  "productHeight": 120.1,
  "referenceLine": [
    {
      "x": 361.1,
      "y": 424.1
    },
    {
      "x": 361.1,
      "y": 289.1
    }
  ],
  "lineLength": 100.1,
  "placement": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  },
  "isRemove": True,
  "removeArea": {
    "x": 85.1,
    "y": 0.1,
    "w": 90.1,
    "h": 250.1
  }
})
headers = {
  'X-API-KEY': 'YOUR_API_KEY',
  'Content-Type': 'application/json'
}

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

print(response.text)