AI Image Enhancement

Submit an AI Image Enhancement Order

Explanation

This API endpoint allows users to submit new orders within the service-image-enhancement service.

---

POST https://api.aihomedesign.com/v1/order

---

Request Body

Ensure that your request body is in the RAW-JSON format.

The service-image-enhancement accepts Enhancement Options as an optional widget. To include a widget in the request body, specify the widget's ID in the selected_widgets as id and the selected widget item's ID as item_id.

{
    "order_id": string,
    "space_name": string,
    "selected_widgets" : 
    [
        {
            "id" : string,
            "item_id" : string
        }
    ]
}

• order_id: This should match the order_id returned by the Image Upload API.

• space_name: Retrieve the space_name using the service_name from the Get Spaces endpoint.

• selected_widgets:

  • id: Retrieve the id for selected_widgets based on the service_name from the Get Widgets endpoint.

  • item_id: Retrieve the item_id for each widget by using its id from the Get Widget Items endpoint.

What is a Space?

A Space refers to a specific area or room associated with the service you’re requesting. For certain services, such as Day to Dusk, the space_name field is required to identify the room type (e.g., indoor, or outdoor).

Using the Get Spaces API, you can fetch all possible spaces based on the service.

In the Image Enhancement service, we offer two spaces: Indoor and outdoor, as shown in the picture below.

Image Enhancement- Spaces (Images shown in this documentation may not reflect the latest updates or design changes on the website.)

What are Widgets and Widget Items?

Widgets are options that enhance your order. Depending on the service, widgets can either be optional or mandatory. For example, a widget might let you choose a design style or color or add specific enhancements to your image.

Widget Items are the specific values or choices available for each widget. For instance, if a widget allows you to select Enhancement Option, the widget items could be options like "Add Fire to Fireplace," "Add Screen to TV" or "Remove Extra Objects".

Use the Get Widgets API to see the available widgets and the Get Widget Items API to explore the choices for each widget, ensuring your order is perfectly tailored to your needs.

In the Image Enhancement service, the Enhancement option is presented as a widget, with the toggles within it functioning as widget items.

Image Enhancement -Enhancement Options Widget & Items (Images shown in this documentation may not reflect the latest updates or design changes on the website.)

Headers

Key	Value
x-api-key*	{your_api_key_here}

Response

200: OK

{
   "order_id": string,
   "image_id": string,
   "eta": integer
}

400: Bad Request

{
    "error": string,
    "key": string
}