Skip to main content
POST
/
proxy
/
freepik
/
v1
/
ai
/
image-relight
Relight an image
curl --request POST \
  --url https://api.comfy.org/proxy/freepik/v1/ai/image-relight \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "image": "<string>",
  "advanced_settings": {
    "blacks": 50,
    "brightness": 50,
    "contrast": 50,
    "engine": "automatic",
    "fixed_generation": false,
    "saturation": 50,
    "transfer_light_a": "automatic",
    "transfer_light_b": "automatic",
    "whites": 50
  },
  "change_background": true,
  "interpolate_from_original": false,
  "light_transfer_strength": 100,
  "preserve_details": true,
  "prompt": "<string>",
  "style": "standard",
  "transfer_light_from_lightmap": "<string>",
  "transfer_light_from_reference_image": "<string>",
  "webhook_url": "https://www.example.com/webhook"
}
'
import requests

url = "https://api.comfy.org/proxy/freepik/v1/ai/image-relight"

payload = {
"image": "<string>",
"advanced_settings": {
"blacks": 50,
"brightness": 50,
"contrast": 50,
"engine": "automatic",
"fixed_generation": False,
"saturation": 50,
"transfer_light_a": "automatic",
"transfer_light_b": "automatic",
"whites": 50
},
"change_background": True,
"interpolate_from_original": False,
"light_transfer_strength": 100,
"preserve_details": True,
"prompt": "<string>",
"style": "standard",
"transfer_light_from_lightmap": "<string>",
"transfer_light_from_reference_image": "<string>",
"webhook_url": "https://www.example.com/webhook"
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)
const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
image: '<string>',
advanced_settings: {
blacks: 50,
brightness: 50,
contrast: 50,
engine: 'automatic',
fixed_generation: false,
saturation: 50,
transfer_light_a: 'automatic',
transfer_light_b: 'automatic',
whites: 50
},
change_background: true,
interpolate_from_original: false,
light_transfer_strength: 100,
preserve_details: true,
prompt: '<string>',
style: 'standard',
transfer_light_from_lightmap: '<string>',
transfer_light_from_reference_image: '<string>',
webhook_url: 'https://www.example.com/webhook'
})
};

fetch('https://api.comfy.org/proxy/freepik/v1/ai/image-relight', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));
<?php

$curl = curl_init();

curl_setopt_array($curl, [
CURLOPT_URL => "https://api.comfy.org/proxy/freepik/v1/ai/image-relight",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'image' => '<string>',
'advanced_settings' => [
'blacks' => 50,
'brightness' => 50,
'contrast' => 50,
'engine' => 'automatic',
'fixed_generation' => false,
'saturation' => 50,
'transfer_light_a' => 'automatic',
'transfer_light_b' => 'automatic',
'whites' => 50
],
'change_background' => true,
'interpolate_from_original' => false,
'light_transfer_strength' => 100,
'preserve_details' => true,
'prompt' => '<string>',
'style' => 'standard',
'transfer_light_from_lightmap' => '<string>',
'transfer_light_from_reference_image' => '<string>',
'webhook_url' => 'https://www.example.com/webhook'
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}
package main

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

func main() {

url := "https://api.comfy.org/proxy/freepik/v1/ai/image-relight"

payload := strings.NewReader("{\n \"image\": \"<string>\",\n \"advanced_settings\": {\n \"blacks\": 50,\n \"brightness\": 50,\n \"contrast\": 50,\n \"engine\": \"automatic\",\n \"fixed_generation\": false,\n \"saturation\": 50,\n \"transfer_light_a\": \"automatic\",\n \"transfer_light_b\": \"automatic\",\n \"whites\": 50\n },\n \"change_background\": true,\n \"interpolate_from_original\": false,\n \"light_transfer_strength\": 100,\n \"preserve_details\": true,\n \"prompt\": \"<string>\",\n \"style\": \"standard\",\n \"transfer_light_from_lightmap\": \"<string>\",\n \"transfer_light_from_reference_image\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\"\n}")

req, _ := http.NewRequest("POST", url, payload)

req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")

res, _ := http.DefaultClient.Do(req)

defer res.Body.Close()
body, _ := io.ReadAll(res.Body)

fmt.Println(string(body))

}
HttpResponse<String> response = Unirest.post("https://api.comfy.org/proxy/freepik/v1/ai/image-relight")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"image\": \"<string>\",\n \"advanced_settings\": {\n \"blacks\": 50,\n \"brightness\": 50,\n \"contrast\": 50,\n \"engine\": \"automatic\",\n \"fixed_generation\": false,\n \"saturation\": 50,\n \"transfer_light_a\": \"automatic\",\n \"transfer_light_b\": \"automatic\",\n \"whites\": 50\n },\n \"change_background\": true,\n \"interpolate_from_original\": false,\n \"light_transfer_strength\": 100,\n \"preserve_details\": true,\n \"prompt\": \"<string>\",\n \"style\": \"standard\",\n \"transfer_light_from_lightmap\": \"<string>\",\n \"transfer_light_from_reference_image\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\"\n}")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.comfy.org/proxy/freepik/v1/ai/image-relight")

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

request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"image\": \"<string>\",\n \"advanced_settings\": {\n \"blacks\": 50,\n \"brightness\": 50,\n \"contrast\": 50,\n \"engine\": \"automatic\",\n \"fixed_generation\": false,\n \"saturation\": 50,\n \"transfer_light_a\": \"automatic\",\n \"transfer_light_b\": \"automatic\",\n \"whites\": 50\n },\n \"change_background\": true,\n \"interpolate_from_original\": false,\n \"light_transfer_strength\": 100,\n \"preserve_details\": true,\n \"prompt\": \"<string>\",\n \"style\": \"standard\",\n \"transfer_light_from_lightmap\": \"<string>\",\n \"transfer_light_from_reference_image\": \"<string>\",\n \"webhook_url\": \"https://www.example.com/webhook\"\n}"

response = http.request(request)
puts response.read_body
{
  "data": {
    "generated": [
      "<string>"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  }
}
{
"error": "<string>",
"message": "<string>"
}
{
"error": "<string>",
"message": "<string>"
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
image
string
required

Base64 or URL of the image to do the relight

advanced_settings
object
change_background
boolean
default:true

When enabled, changes the background based on prompt and/or reference image. Useful for product placement and portraits.

interpolate_from_original
boolean
default:false

When enabled, makes the final image interpolate from the original using the light transfer strength slider.

light_transfer_strength
integer
default:100

Level of light transfer intensity. 0% keeps closest to original, 100% is maximum transfer.

Required range: 0 <= x <= 100
preserve_details
boolean
default:true

Maintains texture and small details of the original image. Good for product photography, texts, etc.

prompt
string

You can guide the generation process and influence the light transfer with a descriptive prompt. IMPORTANT: You can emphasize specific aspects of the light in your prompt by using a number in parentheses, ranging from 1 to 1.4, like "(dark scene:1.3)".

style
enum<string>
default:standard

Style preset for the relight operation.

Available options:
standard,
darker_but_realistic,
clean,
smooth,
brighter,
contrasted_n_hdr,
just_composition
transfer_light_from_lightmap
string

Base64 or URL of the lightmap for light transfer. Incompatible with 'transfer_light_from_reference_image'

transfer_light_from_reference_image
string

Base64 or URL of the reference image for light transfer. Incompatible with 'transfer_light_from_lightmap'

webhook_url
string<uri>

Optional callback URL that will receive asynchronous notifications whenever the task changes status.

Example:

"https://www.example.com/webhook"

Response

OK - The relight process has started

data
object
required