# Clarity Upscaler (`clarity_upscaler`)

> Clarity upscaler. General-purpose image enhancement.

- Capability: Images (tool `image`) — Image to image
- Price: from $0.08 per run (1 credit = $0.01). Exact price for a request: POST https://api.varg.ai/v2/estimate
- Typical time: ~30 s
- JSON Schema: https://api.varg.ai/v2/tools/image?model=clarity_upscaler (public, no key)
- Try it: https://varg.ai/dashboard/tools/playground?model=clarity_upscaler

## Call it

REST: `POST https://api.varg.ai/v2/tools/image/call` with `Authorization: Bearer $VARG_API_KEY` (create a key at https://varg.ai/dashboard/api).
It answers `202` with a job right away. Poll `GET /v2/jobs/{id}` until `status` is `completed`, then read `output.outputs[0].url` — or pass `options.webhook_url` and get the finished job POSTed to you.

```bash
curl -X POST https://api.varg.ai/v2/tools/image/call \
  -H "Authorization: Bearer $VARG_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "clarity_upscaler",
  "files": [
    {
      "url": "https://example.com/input.png"
    }
  ]
}'
```

MCP: the varg server `https://mcp.varg.ai/mcp` (OAuth sign-in, no key) runs it with `call_tool`:

```json
{
  "tool": "image",
  "input": {
    "model": "clarity_upscaler",
    "files": [
      {
        "url": "https://example.com/input.png"
      }
    ]
  },
  "wait": true
}
```

## Inputs

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `model` | string | yes | — | `clarity_upscaler` or a route key below | Which model runs the job. |
| `prompt` | string | no | — | — | — |
| `files` | array of { url } | no | — | — | — |
| `aspect_ratio` | string | no | — | e.g. 16:9 \| 9:16 \| 1:1 \| 4:3 \| 3:4 \| 21:9 \| auto | — |

Media inputs are URLs. Upload a local file first with `POST /v2/files` and pass the returned URL.

## Provider options

Optional, per provider, under `provider_options.<provider>`. Only the options of the provider that runs the job apply — pin a route to choose it.

### provider_options.fal

| field | type | required | default | allowed | description |
|---|---|---|---|---|---|
| `prompt` | string | no | — | — | The prompt to use for generating the image. Be as descriptive as possible for best results. |
| `negative_prompt` | string | no | — | — | The negative prompt to use. Use it to address details that you don't want in the image. |
| `seed` | integer | no | — | 0–9007199254740991 | — |
| `image_url` | string (URL) | no | — | — | The URL of the image to upscale. |
| `creativity` | number | no | — | 0–1 | 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. |
| `resemblance` | number | no | — | 0–1 | 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. |
| `guidance_scale` | number | no | — | 0–20 | 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. |
| `upscale_factor` | number | no | — | 1–4 | The upscale factor |
| `num_inference_steps` | integer | no | — | 4–50 | The number of inference steps to perform. |
| `enable_safety_checker` | boolean | no | — | — | If set to false, the safety checker will be disabled. |

## Routes

`"model": "clarity_upscaler"` picks a route automatically (priority order, then the inputs you send). To pin one, pass its key as `model`.

| model key | provider | modality | price from | typical time |
|---|---|---|---|---|
| `fal:clarity_upscaler` | fal | image-to-image | $0.08 | ~30 s |

---

Catalog version 2026-11-11T12:59:09.901887+00:00. All models: https://varg.ai/models/llms.txt