AI HomeDesign API Docs
  • introduction
    • Getting Started
    • API Key
    • How to Use the API Key?
    • Step-by-Step Guide
  • API Endpoints
    • Getting Started with API Endpoints
    • Image Upload
    • Submit Order
      • AI Virtual Staging
      • AI Interior Design
      • AI Image Enhancement
      • AI Day to Dusk
      • AI Item Removal
      • AI Item Removal Mask
    • Get Spaces
    • Get Widgets and Items
    • Get Order Details
    • Generated Image Webhook
    • Upscale Download Webhook
    • Code Examples
      • Mask Canvas
    • Postman Workspace
  • Usage Limits and Policies
    • Rate Limit
  • Support and Contact
    • Help & Support
    • FAQs
Powered by GitBook
On this page
  • Explanation
  • Request Body
  • Headers
  • Response
  1. API Endpoints
  2. Submit Order

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.

  • selected_widgets:

    • item_id: Retrieve the item_id for each widget by using its id in items key from the Get Widget and 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).

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

What are Widgets and 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.

Items are the specific values or choices available for each widget. For instance, if a widget allows you to select a style, the widget items could be options like "Modern," "Contemporary," or "Scandinavian."

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

Headers

Key
Value

x-api-key*

{your_api_key_here}

Response

{
   "order_id": string,
   "image_id": string,
   "eta": integer
}
{
    "error": string,
    "key": string
}
PreviousAI Interior DesignNextAI Day to Dusk

Last updated 3 months ago

space_name: Retrieve the space_name using the service_name from the .

id: Retrieve the id for selected_widgets based on the service_name from the .

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

Use the to see the available widgets and the items for each widget, ensuring your order is perfectly tailored to your needs.

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