Refresh 🎨

The Refresh endpoint allows you to transform interior spaces by changing wall colors or floor types using advanced AI image processing.

Wall Colors (8 options)

• white - Clean, bright white walls

• egg shell - Soft, warm off-white tone

• black - Bold, dramatic black walls

• gray - Modern, neutral gray

• blue - Classic blue accent

• deep blue - Rich, sophisticated navy

• olive - Earthy, natural green tone

• terracotta - Warm, Mediterranean orange-red

Floor Types (6 options)

• parquet

• tile

• marble

• carpet

• concrete

• hardwood

Endpoint

POST https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh

Headers

Name	Type	Description
Authorization*	String	Bearer {{API_KEY}}

Request Body

Name	Type	Description
url*	String (Url)	Image URL of the room to be redesigned. Ex: https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg
transformation*	String	The type of transformation: walls or floor
value*	String	The color or floor type
webhook	String	(optional) Webhook POST URL to send the result on completion. If not provided, the request will wait for the result.

200: OK If webhook is not set

{
  "base64": "<base64 encoded image>",
  "status": "success"
}

401: Unauthorized

400: Bad Request

500: Internal Server Error

200: OK If webhook is provided

{
  "status": "pending",
  "id": "xxxxxxxxxxxxxx", // You can use that id with Get Job
  "styleId": "your_style",
  "roomId": "your_room",
  "creativity": 14,
  "mode": "redesign"
}

Code Examples

CURL

curl --location 'https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
  "transformation": "walls",
  "value": "white"
}'

Node.js

var myHeaders = new Headers();
myHeaders.append("Authorization", "Bearer {{API_KEY}}");
myHeaders.append("Content-Type", "application/json");

var requestOptions = {
  method: 'POST',
  headers: myHeaders,
  body: JSON.stringify({
    "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
    "transformation": "walls",
    "value": "white"
  })
};

const response = await fetch("https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh", requestOptions)
const body = await reponse.json();
console.log(body)

Python

import requests
import json

url = "https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh"

payload = json.dumps({
  "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
  "transformation": "walls",
  "value": "white"
})
headers = {
  'Authorization': 'Bearer {{API_KEY}}',
  'Content-Type': 'application/json'
}

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

print(response.text)

PHP

<?php
$client = new Client();
$headers = [
  'Authorization' => 'Bearer {{API_KEY}}',
  'Content-Type' => 'application/json'
];
$body = '{
  "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
  "transformation": "walls",
  "value": "white"
}';
$request = new Request('POST', 'https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh', $headers, $body);
$res = $client->sendAsync($request)->wait();
echo $res->getBody();

GO

package main

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

func main() {

  url := "https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh"
  method := "POST"

  payload := strings.NewReader(`{
    "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
    "transformation": "walls",
    "value": "white"
}`)

  client := &http.Client {}
  req, err := http.NewRequest(method, url, payload)

  if err != nil {
    fmt.Println(err)
    return
  }
  req.Header.Add("Authorization", "Bearer {{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))
}

Ruby

require "uri"
require "json"
require "net/http"

url = URI("https://europe-west1-gepettoai.cloudfunctions.net/v1/refresh")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Authorization"] = "Bearer {{API_KEY}}"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "url": "https://theneo-prod-public.s3.amazonaws.com/images-1695201150801.jpg",
  "transformation": "walls",
  "value": "white"
})

response = https.request(request)
puts response.read_body

Results To Expect

Before	After
	transformation: walls, value: white
	transformation: floor, value: parquet