Clarity Upscaler

36.00 credits/megapixel
ae_clarity_upscaler

Upscale an image and enhance its detail, with controls to preserve the original look or add creative refinement.

UpscalingImage
36.00 credits/megapixel

Pricing

36.00 credits per megapixel processed during image upscaling. The upscale factor affects usage.

36.00 credits/megapixel

Parameters

Optional parameters use the platform defaults when omitted.

ParameterTypeRequiredDescriptionDefault
request_bodyobjectYesNo parameter description.—
request_body.seedinteger | unknownNo The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. —
request_body.promptstringNoThe prompt to use for generating the image. Be as descriptive as possible for best results.masterpiece, best quality, highres
request_body.image_urlstringYesThe URL of the image to upscale.—
request_body.creativitynumberNo The creativity of the model. The higher the creativity, the more the model will deviate from the prompt. Refers to the denoise strength of the sampling. 0.35
request_body.resemblancenumberNo The resemblance of the upscaled image to the original image. The higher the resemblance, the more the model will try to keep the original image. Refers to the strength of the ControlNet. 0.6
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. 4
request_body.upscale_factornumberNoThe upscale factor2
request_body.negative_promptstringNoThe negative prompt to use. Use it to address details that you don't want in the image.(worst quality, low quality, normal quality:2)
request_body.num_inference_stepsintegerNoThe number of inference steps to perform.18
request_body.enable_safety_checkerbooleanNoIf set to false, the safety checker will be disabled.true

Invocation example

Copy the request and explore its response example.

POST/agent-api/v1/tool/executeX-Api-Key

Submit first, then query with the returned task_id until the task completes.

Request coderequest.sh
curl --request POST \
  --url 'https://agentearth.ai/agent-api/v1/tool/execute?tool_name=ae_clarity_upscaler' \
  --header "X-Api-Key: $AGENTEARTH_API_KEY" \
  --header 'Content-Type: application/json' \
  --data-raw '{
  "params": {
    "request_body": {
      "creativity": 0.35,
      "enable_safety_checker": false,
      "guidance_scale": 4,
      "image_url": "https://agentearth.ai/fileserver/file/9c136a8c-181f-4a68-a7eb-1e6ec6968653.jpeg",
      "negative_prompt": "(worst quality, low quality, normal quality, blurry, soft focus:2)",
      "num_inference_steps": 24,
      "prompt": "photograph of a cricket insect resting on a white window frame rail, sharp body texture, crisp legs and antennae, natural light, realistic detail",
      "resemblance": 0.7,
      "upscale_factor": 1
    }
  }
}'
Response exampleresponse.json
JSON
{
  "description": "task accepted; poll the result via query_tool with this task_id",
  "query_tool": "ae_get_result",
  "status": "created",
  "task_id": "5067b6a4-4de7-4b95-9996-a7018e7fd803"
}