Iclight V2
120.00 credits/MP
ae_iclight_v2
Relight an existing image with new lighting conditions described in text.
120.00 credits/MP
Pricing
120.00 AE credits per MP. Charge for successfully returned images. Charge proportionally to actual pixels. One MP is 1,000,000 pixels.
120.00 credits/MP
Parameters
Optional parameters use the platform defaults when omitted.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.cfg | number | No | The real classifier-free-guidance scale for the generation. | 1 |
request_body.seed | integer | No | The same seed and the same prompt given to the same version of the model will output the same image every time. | — |
request_body.prompt | string | Yes | The prompt to generate an image from. | — |
request_body.image_url | string | Yes | URL of image to be used for relighting | — |
request_body.sync_mode | boolean | No | If set to true, the function will wait for the image to be generated and uploaded before returning the response. This will increase the latency of the function but it allows you to get the image directly in the response without going through the CDN. | false |
request_body.image_size | object | string | No | The size of the generated image. | — |
request_body.image_size.width | integer | No | The width of the generated image. | 512 |
request_body.image_size.height | integer | No | The height of the generated image. | 512 |
request_body.num_images | integer | No | The number of images to generate. | 1 |
request_body.hr_downscale | number | No | No parameter description. | 0.5 |
request_body.enable_hr_fix | boolean | No | Use HR fix | false |
request_body.output_format | enum (jpeg | png) | No | The format of the generated image. | jpeg |
request_body.guidance_scale | number | No | The CFG (Classifier Free Guidance) scale is a measure of how close you want the model to stick to your prompt when looking for a related image to show you. | 5 |
request_body.initial_latent | enum (None | Left | Right | Top | Bottom) | No | Provide lighting conditions for the model | None |
request_body.lowres_denoise | number | No | Strength for low-resolution pass. | 0.98 |
request_body.mask_image_url | string | No | URL of mask to be used for ic-light conditioning image | — |
request_body.highres_denoise | number | No | Strength for high-resolution pass. Only used if enable_hr_fix is True. | 0.95 |
request_body.negative_prompt | string | No | Negative Prompt for the image | "" |
request_body.num_inference_steps | integer | No | The number of inference steps to perform. | 28 |
request_body.background_threshold | number | No | Threshold for the background removal algorithm. A high threshold will produce sharper masks. Note: This parameter is currently deprecated and has no effect on the output. | 0.67 |
request_body.enable_safety_checker | boolean | No | If set to true, the safety checker will be enabled. | true |
Invocation example
Parameter templateGenerated from the parameter configuration. Replace the sample values before use.
POST
/agent-api/v1/tool/executeX-Api-KeyRequest coderequest.sh
curl --request POST \
--url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_iclight_v2' \
--header "X-Api-Key: $AGENTEARTH_API_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"params": {
"request_body": {
"prompt": "perfume bottle in a volcano surrounded by lava.",
"image_url": "https://storage.googleapis.com/falserverless/iclight-v2/bottle.png"
}
}
}'No response example available yet.







