Clarity Upscaler icon
Image by Clarity

Clarity Upscaler API

Creative "hi-res fix" upscaler — invents detail to taste.

Integrate Clarity Upscaler with a single API call — one key, one unified endpoint, and shared billing across every model on Apiframe.

model: "clarity-upscale"

What's special about Clarity Upscaler

  • Image-to-image editing and reference-image support.
  • Fast turnaround — about 13s per generation on average.
  • Pay-as-you-go pricing with no Clarity account required — you only pay for successful generations.
  • One API key, unified billing, idempotency and webhooks across every Apiframe model.

Made with Clarity Upscaler

A few outputs generated through the Clarity Upscaler API on Apiframe.

Sample coming soon
Sample coming soon
Sample coming soon

Overview

Endpoint
POST /v2/images/upscale
Model ID
clarity-upscale
Params key
clarityUpscaleParams
Modality
image
Provider
Clarity
Pricing
Pay-as-you-go
Avg. completion
~13s

Capabilities

Image inputSupported
Avg. time~13s

Quick start

Send a single POST /v2/images/upscale request with your API key to generate with Clarity Upscaler. The call returns a jobId you can poll or receive via webhook.

curl -X POST https://api.apiframe.ai/v2/images/upscale \
  -H "X-API-Key: afk_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
        "model": "clarity-upscale",
        "clarityUpscaleParams": {
            "image": "https://example.com/input.jpg",
            "prompt": "Optional — describe the kind of detail to add",
            "scale_factor": "2",
            "creativity": 0.35
        }
    }'
import requests

response = requests.post(
    "https://api.apiframe.ai/v2/images/upscale",
    headers={
        "X-API-Key": "afk_your_api_key_here",
        "Content-Type": "application/json",
    },
    json={
        "model": "clarity-upscale",
        "clarityUpscaleParams": {
            "image": "https://example.com/input.jpg",
            "prompt": "Optional — describe the kind of detail to add",
            "scale_factor": "2",
            "creativity": 0.35
        }
    },
)
print(response.json())  # { "jobId": "...", "status": "QUEUED" }
const response = await fetch("https://api.apiframe.ai/v2/images/upscale", {
  method: "POST",
  headers: {
    "X-API-Key": "afk_your_api_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "clarity-upscale",
    "clarityUpscaleParams": {
      "image": "https://example.com/input.jpg",
      "prompt": "Optional — describe the kind of detail to add",
      "scale_factor": "2",
      "creativity": 0.35
    }
  }),
});
const { jobId } = await response.json();
console.log(jobId);

Response & job lifecycle

Generation is asynchronous. A successful submission returns 202 Accepted with a jobId. Poll GET /v2/jobs/{id} (or supply a webhook_url) until the status is COMPLETED; the result field then holds the output URL(s).

1. Submission response (202)

{
  "jobId": "b2c3d4e5-f6a7-8901-bcde-f23456789012",
  "status": "QUEUED"
}

2. Poll for the result

curl https://api.apiframe.ai/v2/jobs/JOB_ID \
  -H "X-API-Key: afk_your_api_key_here"
import requests, time

while True:
    job = requests.get(
        "https://api.apiframe.ai/v2/jobs/JOB_ID",
        headers={"X-API-Key": "afk_your_api_key_here"},
    ).json()
    if job["status"] in ("COMPLETED", "FAILED"):
        break
    time.sleep(2)
print(job["result"])
let job;
do {
  await new Promise((r) => setTimeout(r, 2000));
  job = await fetch("https://api.apiframe.ai/v2/jobs/JOB_ID", {
    headers: { "X-API-Key": "afk_your_api_key_here" },
  }).then((r) => r.json());
} while (job.status !== "COMPLETED" && job.status !== "FAILED");
console.log(job.result);

Input schema

Request parameters accepted by the Clarity Upscaler endpoint. Model-specific options are nested under the params object shown below.

Parameter Type Required Default Allowed / range Description
model string required "clarity-upscale" "clarity-upscale" The model identifier for this endpoint.
clarityUpscaleParams.image string (URL) optional Source image (URL)
clarityUpscaleParams.prompt string optional Steering prompt
clarityUpscaleParams.scale_factor string optional "2" "1", "2", "4", "8" Scale factor
clarityUpscaleParams.creativity number optional 0.35 min 0, max 1, step 0.05 How much new detail Clarity is allowed to invent.
clarityUpscaleParams.resemblance number optional 0.6 min 0, max 3, step 0.05 How tightly to stick to the input.
clarityUpscaleParams.dynamic number optional 6 min 1, max 50, step 1 HDR / dynamic range
clarityUpscaleParams.num_inference_steps number optional 18 min 1, max 100, step 1 Steps
clarityUpscaleParams.output_format string optional "png" "png", "jpg", "webp" Output format
clarityUpscaleParams.seed number optional step 1 Reuse a number to reproduce the same result.

Frequently Asked Questions

Common questions about the Clarity Upscaler API.

Is there an API for Clarity Upscaler?

Yes. Apiframe exposes Clarity Upscaler through a single REST endpoint (`POST /v2/images/upscale` with `model: "clarity-upscale"`). You get one unified API, key, and billing across every supported model — no separate Clarity account required.

How much does the Clarity Upscaler API cost?

Clarity Upscaler uses simple pay-as-you-go pricing on Apiframe — you only pay for successful generations. See the pricing page for plans and volume discounts.

How do I call the Clarity Upscaler API?

Send a POST request to `/v2/images/upscale` with your `X-API-Key` and a JSON body containing `model: "clarity-upscale"`. The call returns a `jobId`; poll `GET /v2/jobs/{id}` or use a webhook to receive the result.

What parameters does Clarity Upscaler support?

Clarity Upscaler accepts 9 model-specific parameters (nested under `clarityUpscaleParams`) plus the common `prompt` and `webhook_url` fields. See the input schema above for the full list with types and defaults.

Still have questions?

Start building with the Clarity Upscaler API

Get your API key and integrate Clarity Upscaler in minutes — Pay-as-you-go.

Free credits to start
One API for every model
Webhooks, SDKs & idempotency
No provider account required

Questions? Join our Discord or contact sales.