이미지 재조명

AI를 사용하여 이미지에 재조명을 적용합니다. 이 엔드포인트는 생성된 이미지를 사용자 정의하기 위한 다양한 파라미터를 허용합니다.

POST /proxy/freepik/v1/ai/image-relight

이미지 재조명

cURL

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

200

{
  "data": {
    "generated": [
      "<string>"
    ],
    "task_id": "046b6c7f-0b8a-43b9-b35d-6489e6daee91"
  }
}

{
  "error": "<string>",
  "message": "<string>"
}

{
  "error": "<string>",
  "message": "<string>"
}

인증

Authorization · string · header · 필수

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

본문

application/json

image · string · 필수

재조명할 이미지의 Base64 또는 URL

advanced_settings · object

Show child attributes

change_background · boolean · 기본값: true

활성화하면 프롬프트 및/또는 참조 이미지를 기반으로 배경을 변경합니다. 제품 배치 및 초상화에 유용합니다.

interpolate_from_original · boolean · 기본값: false

활성화하면 라이트 전송 강도 슬라이더를 사용하여 최종 이미지가 원본에서 보간됩니다.

light_transfer_strength · integer · 기본값: 100

라이트 전송 강도 수준. 0%는 원본에 가장 가깝게 유지하고, 100%는 최대 전송입니다.

필수 범위: 0 <= x <= 100

preserve_details · boolean · 기본값: true

원본 이미지의 질감과 작은 세부 사항을 유지합니다. 제품 사진, 텍스트 등에 적합합니다.

prompt · string

설명 프롬프트를 사용하여 생성 과정을 안내하고 라이트 전송에 영향을 줄 수 있습니다. 중요: 괄호 안에 1에서 1.4 사이의 숫자를 사용하여 프롬프트에서 라이트의 특정 측면을 강조할 수 있습니다. 예: "(dark scene:1.3)".

style · enum<string> · 기본값: standard

재조명 작업을 위한 스타일 프리셋

사용 가능한 옵션: standard, darker_but_realistic, clean, smooth, brighter, contrasted_n_hdr, just_composition

transfer_light_from_lightmap · string

라이트 전송을 위한 라이트맵의 Base64 또는 URL. 'transfer_light_from_reference_image'와 호환되지 않습니다.

transfer_light_from_reference_image · string

라이트 전송을 위한 참조 이미지의 Base64 또는 URL. 'transfer_light_from_lightmap'와 호환되지 않습니다.

webhook_url · string<uri>

작업 상태가 변경될 때마다 비동기 알림을 수신하는 선택적 콜백 URL입니다.

예시:

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

응답

200

application/json

OK - 재조명 프로세스가 시작되었습니다.

data · object · 필수

Show child attributes