Image upscaler API
Image upscaler API for product photos
Make small or soft product photos sharp enough to zoom: 2048 or 4096 pixels on the long side, with stitching, weave, leather grain and metal restored. The composition, colors and product stay the same.
Test keys are free and need no pack.
- 2K (1 credit) or 4K (2 credits).
- Enhanced detail, or a natural sharpen that invents nothing.
- Up to 10 photos per request; letters and logos are kept.


{
"resolution": "4k"
}One request
Every request is asynchronous: the request returns a job in about two seconds, the images follow in 20 to 90 seconds by webhook or by polling.
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());
}
}{
"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"
}Parameters
resolution | Long side of the result: 2k = 2048 px, 4k = 4096 px. |
detail | "enhanced" restores fine material detail; "natural" only sharpens what is there. |
Cost
1 credit per photo at 2k, 2 at 4k
1 API credit = 1 image. Failed and canceled images are refunded automatically.
API pricingWhat people build with it
Zoom on product pages
Images that hold up when shoppers zoom in on the fabric.
Old catalogs
Bring supplier photos and older shots up to today's sizes.
Print and ads
Larger files for print, banners and billboards.
Questions, answered.
What developers ask before connecting Garmo to a shop or a workflow.
Still stuck? Email usWill it change my product?
No. The result keeps the same composition, framing, colors, product and background. Choose detail "natural" to only sharpen what is already there.
What sizes does it make?
2k makes 2048 px on the long side, 4k makes 4096 px, in the photo's own shape.
What does it cost?
1 credit per photo at 2K and 2 credits at 4K.
Other edits in the API
POST /generateClothes color changer APIEvery colorway from one photo, to the exact hex.POST /edit/colorPose changer APIThe back view and the walking shot from one photo.POST /edit/poseModel swap APIThe same outfit and pose on another model.POST /edit/model-swapGhost mannequin APIThe invisible-mannequin shot, without the mannequin.POST /edit/ghost-mannequinBackground changer APIKeep the subject, change the place, match the light.POST /edit/backgroundBackground remover APICut out products onto transparent, white or a brand color.POST /edit/remove-backgroundGet an API key
Test keys are free and need no pack.




