# 1-Point perspective

<div><figure><img src="/files/8nQtHIhKpA9gl7DyAVbh" alt=""><figcaption><p>Before</p></figcaption></figure> <figure><img src="/files/lPOYfzaax6169UmHMPqM" alt=""><figcaption><p>After</p></figcaption></figure></div>

## Description

Generate orthogonal lines on uploaded room images to assist with accurate dimension calculations and room sizing visualizations of a 1-point perspective room image.

## Use cases

1. Accurate space planning and furniture fitting.
2. Enhancing property listings with detailed room dimensions.

## Credit

1 successful Space Design API call = 1 credit.

## API

<mark style="color:green;">`POST`</mark> `https://api.spacely.ai/api/v1/generate/two-point-perspective`

This endpoint is used to advance generate

#### Headers

| Name                                        | Type   | Description |
| ------------------------------------------- | ------ | ----------- |
| X-API-KEY<mark style="color:red;">\*</mark> | String |             |

#### Request Body

| Name                                              | Type      | Description                                                                                                                                                                                                                                                                                                                                                                                |
| ------------------------------------------------- | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| imageUrl<mark style="color:red;">\*</mark>        | String    | <p>The URL of the image representing the room or space to visualize dimensions.</p><p>(e.g., "<a href="https://storage.googleapis.com/spacely/public/image/roomstyle3/bathroom-modern.jpg"><https://storage.googleapis.com/spacely/public/image/roomstyle3/bathroom-modern.jpg></a>").</p>                                                                                                 |
| topLeftLine<mark style="color:red;">\*</mark>     | Object\[] | <p>An array of 2 coordinate objects representing the line on the top left orthogonal line (the connecting line between wall and ceiling at the upper left hand side of the room).</p><p></p><p>Where the first element is the point that is deeper inside the room. The last element is nearer to the camera.</p><p></p><p>e.g. </p><p>\[{ "x": 0, "y": 0},{"x":100.2,"y":100.2}]</p>      |
| topRightLine<mark style="color:red;">\*</mark>    | Object\[] | <p>An array of 2 coordinate objects representing the line on the top right orthogonal line (the connecting line between wall and ceiling at the upper right hand side of the room).</p><p></p><p>Where the first element is the point that is deeper inside the room. The last element is nearer to the camera.</p><p></p><p>e.g. </p><p>\[{ "x": 0, "y": 0},{"x":100.2,"y":100.2}]</p>    |
| roomHeight<mark style="color:red;">\*</mark>      | Float     | The height of the room/space. Must be in meter.                                                                                                                                                                                                                                                                                                                                            |
| bottomLeftLine<mark style="color:red;">\*</mark>  | Object\[] | <p>An array of 2 coordinate objects representing the line on the bottom left orthogonal line (the connecting line between wall and ceiling at the lower left hand side of the room).</p><p></p><p>Where the first element is the point that is deeper inside the room. The last element is nearer to the camera.</p><p></p><p>e.g. </p><p>\[{ "x": 0, "y": 0},{"x":100.2,"y":100.2}]</p>   |
| bottomRightLine<mark style="color:red;">\*</mark> | Object\[] | <p>An array of 2 coordinate objects representing the line on the bottom right orthogonal line (the connecting line between wall and ceiling at the lower right hand side of the room).</p><p></p><p>Where the first element is the point that is deeper inside the room. The last element is nearer to the camera.</p><p></p><p>e.g. </p><p>\[{ "x": 0, "y": 0},{"x":100.2,"y":100.2}]</p> |
| roomWidth                                         | Float     | The width of the room/space. Must be in meter.                                                                                                                                                                                                                                                                                                                                             |
| referenceLine                                     | Object\[] | <p>An array of 2 coordinate objects representing the 1-meter line on the bottom right orthogonal line </p><p></p><p>Where the first element is the point that is deeper inside the room. The last element is 1 meter from the former.</p><p></p><p>e.g. </p><p>\[{ "x": 0, "y": 0},{"x":100.2,"y":100.2}]</p>                                                                              |

{% tabs %}
{% tab title="200: OK Response ref Id for pulling data" %}

```json
{
  "data": "63d17492-43d9-4161-0000-b067be1316dc"
}
```

{% endtab %}

{% tab title="400: Bad Request Not Found: Requested resource not found on the server." %}

{% endtab %}

{% tab title="401: Unauthorized The API key provided was invalid or missing." %}

{% endtab %}

{% tab title="500: Internal Server Error Unexpected condition on the server preventing request fulfillment." %}

{% endtab %}
{% endtabs %}

## Example

{% tabs %}
{% tab title="cURL" %}

```sh
curl --location 'https://api.spacely.ai/api/v1/generate/one-point-perspective' \
--header 'X-API-KEY: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
    "imageUrl": "IMAGE_URL",
    "topLeftLine": [
        {
            "x": 68.57142857142857,
            "y": 28.4534351245777
        },
        {
            "x": 33.38345864661654,
            "y": -0.3753937042511261
        }
    ],
    "topRightLine": [
        {
            "x": 520.6015037593985,
            "y": 28.716216216216218
        },
        {
            "x": 555.7894736842105,
            "y": 0.7882882882882883
        }
    ],
    "bottomLeftLine": [
        {
            "x": 65.86466165413533,
            "y": 300.45045045045043
        },
        {
            "x": 0,
            "y": 340.0900900900901
        }
    ],
    "bottomRightLine": [
        {
            "x": 521.5037593984962,
            "y": 297.1095729518581
        },
        {
            "x": 599.0977443609023,
            "y": 352.06452790681305
        }
    ],
    "referenceLine": [
        {
            "x": 520.6015037593985,
            "y": 301.20118287232543
        },
        {
            "x": 572.0300751879699,
            "y": 334.5345162056588
        }
    ],
    "roomHeight": 3,
    "roomWidth": 4
}'

```

{% endtab %}

{% tab title="JavaScript  " %}

```javascript
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",
  "topLeftLine": [
    {
      "x": 68.57142857142857,
      "y": 28.4534351245777
    },
    {
      "x": 33.38345864661654,
      "y": -0.3753937042511261
    }
  ],
  "topRightLine": [
    {
      "x": 520.6015037593985,
      "y": 28.716216216216218
    },
    {
      "x": 555.7894736842105,
      "y": 0.7882882882882883
    }
  ],
  "bottomLeftLine": [
    {
      "x": 65.86466165413533,
      "y": 300.45045045045043
    },
    {
      "x": 0,
      "y": 340.0900900900901
    }
  ],
  "bottomRightLine": [
    {
      "x": 521.5037593984962,
      "y": 297.1095729518581
    },
    {
      "x": 599.0977443609023,
      "y": 352.06452790681305
    }
  ],
  "referenceLine": [
    {
      "x": 520.6015037593985,
      "y": 301.20118287232543
    },
    {
      "x": 572.0300751879699,
      "y": 334.5345162056588
    }
  ],
  "roomHeight": 3,
  "roomWidth": 4
});

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

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

{% endtab %}

{% tab title="NodeJs" %}

```javascript
const axios = require('axios');
let data = JSON.stringify({
  "imageUrl": "IMAGE_URL",
  "topLeftLine": [
    {
      "x": 68.57142857142857,
      "y": 28.4534351245777
    },
    {
      "x": 33.38345864661654,
      "y": -0.3753937042511261
    }
  ],
  "topRightLine": [
    {
      "x": 520.6015037593985,
      "y": 28.716216216216218
    },
    {
      "x": 555.7894736842105,
      "y": 0.7882882882882883
    }
  ],
  "bottomLeftLine": [
    {
      "x": 65.86466165413533,
      "y": 300.45045045045043
    },
    {
      "x": 0,
      "y": 340.0900900900901
    }
  ],
  "bottomRightLine": [
    {
      "x": 521.5037593984962,
      "y": 297.1095729518581
    },
    {
      "x": 599.0977443609023,
      "y": 352.06452790681305
    }
  ],
  "referenceLine": [
    {
      "x": 520.6015037593985,
      "y": 301.20118287232543
    },
    {
      "x": 572.0300751879699,
      "y": 334.5345162056588
    }
  ],
  "roomHeight": 3,
  "roomWidth": 4
});

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


```

{% endtab %}

{% tab title="Go" %}

```go
package main

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

func main() {

  url := "https://api.spacely.ai/api/v1/generate/one-point-perspective"
  method := "POST"

  payload := strings.NewReader(`{
    "imageUrl": "IMAGE_URL",
    "topLeftLine": [
        {
            "x": 68.57142857142857,
            "y": 28.4534351245777
        },
        {
            "x": 33.38345864661654,
            "y": -0.3753937042511261
        }
    ],
    "topRightLine": [
        {
            "x": 520.6015037593985,
            "y": 28.716216216216218
        },
        {
            "x": 555.7894736842105,
            "y": 0.7882882882882883
        }
    ],
    "bottomLeftLine": [
        {
            "x": 65.86466165413533,
            "y": 300.45045045045043
        },
        {
            "x": 0,
            "y": 340.0900900900901
        }
    ],
    "bottomRightLine": [
        {
            "x": 521.5037593984962,
            "y": 297.1095729518581
        },
        {
            "x": 599.0977443609023,
            "y": 352.06452790681305
        }
    ],
    "referenceLine": [
        {
            "x": 520.6015037593985,
            "y": 301.20118287232543
        },
        {
            "x": 572.0300751879699,
            "y": 334.5345162056588
        }
    ],
    "roomHeight": 3,
    "roomWidth": 4
}`)

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

{% endtab %}

{% tab title="Python" %}

```python
import requests
import json

url = "https://api.spacely.ai/api/v1/generate/one-point-perspective"

payload = json.dumps({
  "imageUrl": "IMAGE_URL",
  "topLeftLine": [
    {
      "x": 68.57142857142857,
      "y": 28.4534351245777
    },
    {
      "x": 33.38345864661654,
      "y": -0.3753937042511261
    }
  ],
  "topRightLine": [
    {
      "x": 520.6015037593985,
      "y": 28.716216216216218
    },
    {
      "x": 555.7894736842105,
      "y": 0.7882882882882883
    }
  ],
  "bottomLeftLine": [
    {
      "x": 65.86466165413533,
      "y": 300.45045045045043
    },
    {
      "x": 0,
      "y": 340.0900900900901
    }
  ],
  "bottomRightLine": [
    {
      "x": 521.5037593984962,
      "y": 297.1095729518581
    },
    {
      "x": 599.0977443609023,
      "y": 352.06452790681305
    }
  ],
  "referenceLine": [
    {
      "x": 520.6015037593985,
      "y": 301.20118287232543
    },
    {
      "x": 572.0300751879699,
      "y": 334.5345162056588
    }
  ],
  "roomHeight": 3,
  "roomWidth": 4
})
headers = {
  'X-API-KEY': 'YOUR_API_KEY',
  'Content-Type': 'application/json'
}

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

print(response.text)
```

{% endtab %}
{% endtabs %}

## Support

Any question? Contact us at <support@spacely.ai>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.enterprise.spacely.ai/spacely-ai-enterprise/precision-space-planning-api/1-point-perspective.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.