Iclight V2

120.00 credits/MP
ae_iclight_v2

Relight an existing image with new lighting conditions described in text.

Image
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.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.cfgnumberNoThe real classifier-free-guidance scale for the generation.1
request_body.seedintegerNo The same seed and the same prompt given to the same version of the model will output the same image every time. —
request_body.promptstringYesThe prompt to generate an image from.—
request_body.image_urlstringYesURL of image to be used for relighting—
request_body.sync_modebooleanNo 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_sizeobject | stringNoThe size of the generated image.—
request_body.image_size.widthintegerNoThe width of the generated image.512
request_body.image_size.heightintegerNoThe height of the generated image.512
request_body.num_imagesintegerNoThe number of images to generate.1
request_body.hr_downscalenumberNoNo parameter description.0.5
request_body.enable_hr_fixbooleanNoUse HR fixfalse
request_body.output_formatenum (jpeg | png)NoThe format of the generated image.jpeg
request_body.guidance_scalenumberNo 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_latentenum (None | Left | Right | Top | Bottom)No Provide lighting conditions for the model None
request_body.lowres_denoisenumberNoStrength for low-resolution pass.0.98
request_body.mask_image_urlstringNoURL of mask to be used for ic-light conditioning image—
request_body.highres_denoisenumberNoStrength for high-resolution pass. Only used if enable_hr_fix is True.0.95
request_body.negative_promptstringNoNegative Prompt for the image""
request_body.num_inference_stepsintegerNoThe number of inference steps to perform.28
request_body.background_thresholdnumberNoThreshold 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_checkerbooleanNoIf set to true, the safety checker will be enabled.true

Invocation example

Parameter template

Generated from the parameter configuration. Replace the sample values before use.

POST/agent-api/v1/tool/executeX-Api-Key
Request 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.