Upscale
POST/edit/upscale
Makes a product photo sharp at 2048 or 4096 px on the long side, restoring fabric and material detail without changing the photo.
Cost: 1 credit per photo at 2k, 2 at 4k. Images: Send one photo the same way, or up to 10 in images[] (or multipart files named images[]). It makes one image per photo, at most 12 per request.
Overview and examples: Image upscaler API.
Parameters
| Parameter | Description |
|---|---|
resolutionstring | Long side of the result: 2k = 2048 px, 4k = 4096 px. Default "2k".One of: 2k, 4k |
detailstring | "enhanced" restores fine material detail; "natural" only sharpens what is there. Default "enhanced".One of: enhanced, natural |
image_urlstring | Public https URL of the photo to edit. JPEG, PNG or WebP, up to 12 MB. Private and local addresses are refused. |
image_base64string | The photo itself, base64-encoded (a data: URI is fine). For large files use upload_id instead. |
upload_idstring | An id from POST /uploads. |
imagesarray | Several photos at once (up to 10); each item is a URL string or an object with image_url, image_base64 or upload_id. Each photo is edited on its own. |
webhook_urlstring | https address Garmo POSTs the finished job to (signed, see Webhooks). |
metadataobject | Your own JSON object (up to 1,000 characters), returned with the job and in the webhook. |
Header Idempotency-Key (optional): see Retries and idempotency.
Example
curl https://api.garmo.studio/v1/edit/upscale \
-H "Authorization: Bearer $GARMO_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"images": [
"https://shop.example/p/ring-1.jpg",
"https://shop.example/p/ring-2.jpg"
],
"resolution": "4k"
}'const r = await fetch("https://api.garmo.studio/v1/edit/upscale", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GARMO_API_KEY}`,
"Idempotency-Key": "order-123-upscale",
"Content-Type": "application/json",
},
body: JSON.stringify({"images": ["https://shop.example/p/ring-1.jpg", "https://shop.example/p/ring-2.jpg"], "resolution": "4k"}),
});
const job = await r.json();
console.log(job.id, job.status);import os, requests
r = requests.post(
"https://api.garmo.studio/v1/edit/upscale",
headers={"Authorization": f"Bearer {os.environ['GARMO_API_KEY']}", "Idempotency-Key": "order-123-upscale"},
json={
"images": ["https://shop.example/p/ring-1.jpg", "https://shop.example/p/ring-2.jpg"],
"resolution": "4k",
},
)
job = r.json()
print(job["id"], job["status"])<?php
$ch = curl_init("https://api.garmo.studio/v1/edit/upscale");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode(["images" => ["https://shop.example/p/ring-1.jpg", "https://shop.example/p/ring-2.jpg"], "resolution" => "4k"]),
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GARMO_API_KEY"), "Idempotency-Key: order-123-upscale", "Content-Type: application/json"],
]);
$job = json_decode(curl_exec($ch), true);
echo $job["id"], " ", $job["status"];require "net/http"
require "json"
uri = URI("https://api.garmo.studio/v1/edit/upscale")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("GARMO_API_KEY")}"
req["Idempotency-Key"] = "order-123-upscale"
req["Content-Type"] = "application/json"
req.body = <<~'JSON'
{
"images": [
"https://shop.example/p/ring-1.jpg",
"https://shop.example/p/ring-2.jpg"
],
"resolution": "4k"
}
JSON
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
job = JSON.parse(res.body)
puts job["id"], job["status"]package main
import (
"fmt"
"io"
"net/http"
"os"
"strings"
)
func main() {
body := strings.NewReader(`{
"images": [
"https://shop.example/p/ring-1.jpg",
"https://shop.example/p/ring-2.jpg"
],
"resolution": "4k"
}`)
req, _ := http.NewRequest("POST", "https://api.garmo.studio/v1/edit/upscale", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("GARMO_API_KEY"))
req.Header.Set("Idempotency-Key", "order-123-upscale")
req.Header.Set("Content-Type", "application/json")
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
out, _ := io.ReadAll(res.Body)
fmt.Println(res.Status, string(out))
}import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
public class Garmo {
public static void main(String[] args) throws Exception {
String body = """
{
"images": [
"https://shop.example/p/ring-1.jpg",
"https://shop.example/p/ring-2.jpg"
],
"resolution": "4k"
}
""";
HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.garmo.studio/v1/edit/upscale"))
.header("Authorization", "Bearer " + System.getenv("GARMO_API_KEY"))
.header("Idempotency-Key", "order-123-upscale")
.header("Content-Type", "application/json")
.POST(HttpRequest.BodyPublishers.ofString(body))
.build();
HttpResponse<String> res = HttpClient.newHttpClient().send(req, HttpResponse.BodyHandlers.ofString());
System.out.println(res.statusCode() + " " + res.body());
}
}Response: 202 Accepted
{
"id": "job_8Kq2xV7mPz4LtR9wNc3B",
"object": "job",
"tool": "upscale",
"status": "processing",
"livemode": true,
"outputs": [
{
"id": "out_1",
"status": "processing",
"label": "4K"
},
{
"id": "out_2",
"status": "processing",
"label": "4K"
}
],
"credits_charged": 4,
"credits_refunded": 0,
"metadata": {
"sku": "DR-123"
},
"created_at": "2026-11-19T14:02:11Z",
"completed_at": null
}The finished job
{
"id": "job_8Kq2xV7mPz4LtR9wNc3B",
"object": "job",
"tool": "upscale",
"status": "completed",
"livemode": true,
"outputs": [
{
"id": "out_1",
"status": "succeeded",
"label": "4K",
"url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…0.webp?X-Amz-Signature=…",
"url_expires_at": "2026-11-20T14:00:00Z"
},
{
"id": "out_2",
"status": "succeeded",
"label": "4K",
"url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…1.webp?X-Amz-Signature=…",
"url_expires_at": "2026-11-20T14:00:00Z"
}
],
"credits_charged": 4,
"credits_refunded": 0,
"metadata": {
"sku": "DR-123"
},
"created_at": "2026-11-19T14:02:11Z",
"completed_at": "2026-11-19T14:02:58Z"
}Errors
400 invalid_request names the parameter that is missing or wrong. Image problems are invalid_image, image_too_large or image_unreachable. 402 insufficient_credits says how many credits the request needs. All codes: Errors.




