Interior Sky API

The Interior Sky service allows you to enhance the view from your interior windows by replacing the visible sky with a perfect blue sky and optimizing visible landscapes.

Generate an interior sky

Calling this endpoint launches a new generation to enhance exterior views visible through windows. This operation also creates a new project and, depending on your subscription, it is possible to obtain free variations.

Request Parameters

string

required

The unique user identifier (UUID) that you can retrieve from your Developer Space

string

required

URL of the interior image to enhance (format: jpg, png)

string

The URL we call once the generation is complete

Response

string

The unique generation identifier (UUID) to use with the retrieval API

number

The number of photos remaining after this generation

string

The unique project identifier (UUID)

Request Example

curl --request POST \
--url 'https://iacrea.com/api/sky_interior/generate' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "image_url": "https://example.com/interior.jpg"
}'

Response Example

{
  "generation_id": "uuid",
  "remaining_photos": 100,
  "project_id": "uuid"
}

Generate a variation of an interior sky

This endpoint allows you to generate a variation of a previously generated interior sky.

Request Parameters

string

required

The unique user identifier (UUID)

string

required

The unique identifier of the previous generation

Response

string

The unique identifier of the new generation

number

The number of photos remaining after this generation

Request Example

curl --request POST \
--url 'https://iacrea.com/api/sky_interior/generate-variation' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

Response Example

{
  "generation_id": "uuid",
  "remaining_photos": 100
}

Retrieve a generated interior sky

This endpoint allows you to obtain the result of a previously performed generation.

Request Parameters

string

required

The unique user identifier (UUID)

string

required

The unique identifier of the generation to retrieve

Response

string

The generation status: “STARTING”, “PROCESSING”, “SUCCEEDED”, “FAILED”

array

An array containing the URLs of generated images (present only if status=“SUCCEEDED”)

number

The number of variations already performed on this project

Request Example

curl --request POST \
--url 'https://iacrea.com/api/sky_interior/get' \
--header 'x-api-key: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
  "user_id": "uuid",
  "generation_id": "uuid"
}'

Response Example

{
  "status": "SUCCEEDED",
  "urls": ["https://generated-image-url"],
  "variationNumber": 2
}

API Documentation

Endpoints

Interior Sky API

Interior Sky API

Generate an interior sky

Request Parameters

Response

Request Example

Response Example

Generate a variation of an interior sky

Request Parameters

Response

Request Example

Response Example

Retrieve a generated interior sky

Request Parameters

Response

Request Example

Response Example

​Interior Sky API

​Generate an interior sky

​Request Parameters

​Response

​Request Example

​Response Example

​Generate a variation of an interior sky

​Request Parameters

​Response

​Request Example

​Response Example

​Retrieve a generated interior sky

​Request Parameters

​Response

​Request Example

​Response Example

Interior Sky API

Generate an interior sky

Request Parameters

Response

Request Example

Response Example

Generate a variation of an interior sky

Request Parameters

Response

Request Example

Response Example

Retrieve a generated interior sky

Request Parameters

Response

Request Example

Response Example