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.
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
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.
Questions? Join our Discord or contact sales.