Magic Enhancer ✨

The magic enhancer will enhance your photos contrast, exposure, color and brightness to make them more appealing. The Magic Enhancer also lets you fix the sky and hide people's faces or plates.

⚠️ Enhancer is a add-on of the Gepetto API billed separately, per request.

Pricing

Quantity	Cost per request
0 to 1000 request	0.25€ Excl Taxes
1001 to 10000	0,22 € Excl Taxes
10001 and above	0,18 € Excl Taxes

Endpoint

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

Headers

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

Request Body

Name	Type	Description
url*	String	Image URL of the room to be enhanced 💡 better to use high definition images. Ex: https://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa
sky_fix	Boolean (true / false)	(optional) Will change a grey sky to a blue sky.
auto_privacy	Boolean (true / false)	(optional) Will blur faces and car plates.
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"
}

200: OK If webhook is provided

{
  "status": "pending",
  "id": "xxxxxxxxxxxxxx", // You can use that id with Get Job
  "mode": "enhance"
}

400: Bad Request

401: Unauthorized

500: Internal Server Error

Code Examples

CURL

curl --location 'https://europe-west1-gepettoai.cloudfunctions.net/v1/enhancer' \
--header 'Authorization: Bearer {{API_KEY}}' \
--header 'Content-Type: application/json' \
--data '{
  "url": "https://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
  "sky_fix": true,
  "auto_privacy": false,
}'

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://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
    "sky_fix": true,
    "auto_privacy": false
  })
};

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

Python

import requests
import json

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

payload = json.dumps({
  "url": "https://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
  "sky_fix": True,
  "auto_privacy": False
})
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://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
  "sky_fix": True,
  "auto_privacy": False
}';
$request = new Request('POST', 'https://europe-west1-gepettoai.cloudfunctions.net/v1/enhancer', $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/enhancer"
  method := "POST"

  payload := strings.NewReader(`{
    "url": "https://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
    "sky_fix": true,
    "auto_privacy": false
}`)

  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/smart-staging")

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://firebasestorage.googleapis.com/v0/b/gepettoai.appspot.com/o/raw-images%2Ffd6db4d6-aaf6-4563-9340-c7c2b59fe69e.jpeg?alt=media&token=4d3b728a-5ebc-4a55-a694-1c21c580c8aa",
  "sky_fix": true,
  "auto_privacy": false
})

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

Results