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.
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.
| Parameter | Type | Required | Description | Default |
|---|---|---|---|---|
request_body | object | Yes | No parameter description. | — |
request_body.seed | integer | unknown | No | The same seed and the same prompt given to the same version of Stable Diffusion will output the same image every time. | — |
request_body.prompt | string | No | The prompt to use for generating the image. Be as descriptive as possible for best results. | masterpiece, best quality, highres |
request_body.image_url | string | Yes | The URL of the image to upscale. | — |
request_body.creativity | number | No | 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.resemblance | number | No | 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_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. | 4 |
request_body.upscale_factor | number | No | The upscale factor | 2 |
request_body.negative_prompt | string | No | The 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_steps | integer | No | The number of inference steps to perform. | 18 |
request_body.enable_safety_checker | boolean | No | If 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-KeySubmit 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
{
"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"
}


