Relight an image

Relight an image using AI. This endpoint accepts a variety of parameters to customize the generated images.

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

Relight an image

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"
}
'

200

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

授权

Authorization · string · header · 必填

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

请求体

application/json

image · string · 必填

Base64 or URL of the image to do the relight

advanced_settings · object

Show child attributes

change_background · boolean · 默认值: true

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

interpolate_from_original · boolean · 默认值: false

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

light_transfer_strength · integer · 默认值: 100

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

必填范围: 0 <= x <= 100

preserve_details · boolean · 默认值: 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> · 默认值: standard

Style preset for the relight operation.

可用选项: 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.

示例:

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

响应

200

application/json

OK - The relight process has started

data · object · 必填

Show child attributes