API di Garmo
L'API AI per le foto di moda e le foto prodotto
Garmo Studio via HTTP: invia una foto prodotto e un prompt per avere nuove foto prodotto o indossate, oppure modifica le foto che hai: varianti colore, pose, modelle, sfondi e 4K. Pensata per abbigliamento, scarpe, borse e gioielli, con lo stesso account dell'app.
Le chiavi di test sono gratuite e non richiedono pacchetti. La documentazione tecnica è in inglese.



{
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}Crea e modifica, una sola API
Ogni endpoint fa una cosa sola e la fa bene, senza toccare il prodotto: colore, tessuto, stampa, logo e cuciture.
Prima
DopoAPI shooting foto prodottoUna foto prodotto e un prompt: nuove foto, indossate o no.POST /generate
Prima
DopoAPI per cambiare colore ai vestitiOgni variante colore da una foto, al codice hex esatto.POST /edit/color
Prima
DopoAPI per cambiare posaLa vista di schiena e lo scatto in movimento da una sola foto.POST /edit/pose
Prima
DopoAPI per cambiare modellaLo stesso look e la stessa posa su un’altra modella.POST /edit/model-swap
Prima
DopoAPI manichino invisibileL’effetto manichino invisibile, senza manichino.POST /edit/ghost-mannequin
Prima
DopoAPI per cambiare sfondoIl prodotto resta, cambiano luogo e luce.POST /edit/background
Prima
DopoAPI per rimuovere lo sfondoScontorna il prodotto su trasparente, bianco o il tuo colore.POST /edit/remove-background
Prima
DopoAPI per migliorare la qualità delle fotoFoto prodotto in 2K o 4K con il vero dettaglio dei materiali.POST /edit/upscaleCome funziona, passo dopo passo
Dalla chiave all'immagine finita in quattro passi. Il tuo codice non aspetta mai: Garmo lavora in background e ti avvisa quando le immagini sono pronte.
- 01
Crea una chiave
In Garmo Studio apri Sviluppatori › API e crea una chiave. La chiave di test è gratuita e restituisce la tua foto come risultato, così costruisci tutta l'integrazione prima di pagare.
gm_test_•••••••• - 02
Invia la foto
Invia la foto prodotto (un URL, il file o l’id di un upload) con una POST insieme a un prompt, oppure a un endpoint di modifica con i suoi parametri.
POST /generate - 03
Ricevi subito un job
La risposta arriva in circa due secondi con l'id del job e lo stato processing. Garmo crea le immagini in 20–90 secondi.
202 · processing - 04
Ricevi le immagini
Quando il job finisce arriva un webhook firmato, oppure controlli GET /jobs/{id}. Ogni immagine è un link di download valido un giorno; un’immagine non riuscita restituisce il suo credito.
job.completed
curl https://api.garmo.studio/v1/generate \
-H "Authorization: Bearer $GARMO_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"image_url": "https://shop.example/products/sundress-41.jpg",
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}'const r = await fetch("https://api.garmo.studio/v1/generate", {
method: "POST",
headers: {
Authorization: `Bearer ${process.env.GARMO_API_KEY}`,
"Idempotency-Key": "order-123-generate",
"Content-Type": "application/json",
},
body: JSON.stringify({"image_url": "https://shop.example/products/sundress-41.jpg", "model": "auto", "prompt": "a sunlit stone colonnade, warm late-afternoon light", "count": 2}),
});
const job = await r.json();
console.log(job.id, job.status);import os, requests
r = requests.post(
"https://api.garmo.studio/v1/generate",
headers={"Authorization": f"Bearer {os.environ['GARMO_API_KEY']}", "Idempotency-Key": "order-123-generate"},
json={
"image_url": "https://shop.example/products/sundress-41.jpg",
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2,
},
)
job = r.json()
print(job["id"], job["status"])<?php
$ch = curl_init("https://api.garmo.studio/v1/generate");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_POSTFIELDS => json_encode(["image_url" => "https://shop.example/products/sundress-41.jpg", "model" => "auto", "prompt" => "a sunlit stone colonnade, warm late-afternoon light", "count" => 2]),
CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("GARMO_API_KEY"), "Idempotency-Key: order-123-generate", "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/generate")
req = Net::HTTP::Post.new(uri)
req["Authorization"] = "Bearer #{ENV.fetch("GARMO_API_KEY")}"
req["Idempotency-Key"] = "order-123-generate"
req["Content-Type"] = "application/json"
req.body = <<~'JSON'
{
"image_url": "https://shop.example/products/sundress-41.jpg",
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}
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(`{
"image_url": "https://shop.example/products/sundress-41.jpg",
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}`)
req, _ := http.NewRequest("POST", "https://api.garmo.studio/v1/generate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("GARMO_API_KEY"))
req.Header.Set("Idempotency-Key", "order-123-generate")
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 = """
{
"image_url": "https://shop.example/products/sundress-41.jpg",
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}
""";
HttpRequest req = HttpRequest.newBuilder(URI.create("https://api.garmo.studio/v1/generate"))
.header("Authorization", "Bearer " + System.getenv("GARMO_API_KEY"))
.header("Idempotency-Key", "order-123-generate")
.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": "generate",
"status": "processing",
"livemode": true,
"outputs": [
{
"id": "out_1",
"status": "processing",
"label": "Front"
},
{
"id": "out_2",
"status": "processing",
"label": "Walking"
}
],
"credits_charged": 2,
"credits_refunded": 0,
"metadata": {
"sku": "DR-123"
},
"created_at": "2026-11-19T14:02:11Z",
"completed_at": null
}{
"id": "job_8Kq2xV7mPz4LtR9wNc3B",
"object": "job",
"tool": "generate",
"status": "completed",
"livemode": true,
"outputs": [
{
"id": "out_1",
"status": "succeeded",
"label": "Front",
"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": "Walking",
"url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…1.webp?X-Amz-Signature=…",
"url_expires_at": "2026-11-20T14:00:00Z"
}
],
"credits_charged": 2,
"credits_refunded": 0,
"metadata": {
"sku": "DR-123"
},
"created_at": "2026-11-19T14:02:11Z",
"completed_at": "2026-11-19T14:02:58Z"
}{
"id": "evt_1842a7c9e3ea2b51",
"type": "job.completed",
"created_at": "2026-11-19T14:02:59Z",
"data": {
"id": "job_8Kq2xV7mPz4LtR9wNc3B",
"object": "job",
"tool": "generate",
"status": "completed",
"livemode": true,
"outputs": [
{
"id": "out_1",
"status": "succeeded",
"label": "Front",
"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": "Walking",
"url": "https://….r2.cloudflarestorage.com/renders/2026/11/8f3c…1.webp?X-Amz-Signature=…",
"url_expires_at": "2026-11-20T14:00:00Z"
}
],
"credits_charged": 2,
"credits_refunded": 0,
"metadata": {
"sku": "DR-123"
},
"created_at": "2026-11-19T14:02:11Z",
"completed_at": "2026-11-19T14:02:58Z"
}
}{
"error": {
"code": "invalid_request",
"message": "count must be a whole number from 1 to 4.",
"request_id": "req_7fHs2KqPz9LwXcVb"
}
}{
"error": {
"code": "invalid_api_key",
"message": "This API key is not valid. It may have been revoked.",
"request_id": "req_Mt4nB8xRe1JyQoUa"
}
}{
"error": {
"code": "insufficient_credits",
"message": "This request needs 2 API credits; the balance is 0. Buy an API pack in Garmo Studio.",
"request_id": "req_XNnjm6TTkLMMNnVq"
}
}{
"error": {
"code": "concurrency_limited",
"message": "Your account can have 10 images rendering at once and 10 are still rendering. Try again when some finish.",
"request_id": "req_Q2v8LmYt0pRk4sWd"
}
}Tutti i codici di errore →400401402403404409413429500503
Funziona anche con Gemini CLI, GitHub Copilot e qualsiasi agente che possa chiamare un’API.
Agenti di coding
Usa Garmo da Claude Code, Codex e Cursor
Il tuo agente trova le foto prodotto, invia la richiesta e salva le immagini finite nella tua cartella. Tu descrivi cosa vuoi, senza scrivere codice.
Ogni pagina della documentazione è anche in Markdown, così qualsiasi agente può leggerla e creare immagini dal tuo prompt. Oppure installa una volta lo skill di Garmo e chiedi e basta.
Installa lo skill per Claude Code, Codex e Cursor
for d in ~/.claude/skills ~/.codex/skills; do
mkdir -p "$d/garmo" && curl -fsSL https://garmo.studio/api/skill/SKILL.md -o "$d/garmo/SKILL.md"
donePerché Garmo
Pensata per la moda
Le istruzioni dietro ogni endpoint sono tarate su capi e prodotti: il raso mantiene la sua lucentezza quando cambia colore, la stampa resta al suo posto quando cambia la posa.
Un account per Studio e API
Lo stesso account Garmo funziona in Studio e tramite API, e i job dell'API compaiono nella tua libreria di Studio.
Chiavi di test gratuite
Una chiave gm_test_ chiama ogni endpoint gratis e restituisce la tua foto come risultato. Costruisci tutto prima di acquistare.
Pronta per la produzione
Chiavi di idempotenza, webhook firmati con nuovi tentativi e codici di errore chiari. Un’immagine non riuscita restituisce da sola il suo credito.
Cosa ci si costruisce
Sincronizzare il catalogo
Nuovo prodotto nello shop → un’immagine per ogni variante colore e una su fondo bianco, salvate nella scheda.
Automazioni no-code
Chiamala da n8n, Make o Zapier con un semplice passo HTTP; il webhook avvia il passo successivo.
Annunci sui marketplace
Manichino invisibile e upscale per ogni foto prima della pubblicazione.
Pacchetti di crediti API
Acquisti una tantum dalla pagina API di Garmo Studio. I crediti API sono separati dai crediti Studio e dagli abbonamenti.
- 10 richieste di creazione / min
- 3 immagini in parallelo
- 120 letture / min
- 20 richieste di creazione / min
- 6 immagini in parallelo
- 300 letture / min
- 40 richieste di creazione / min
- 10 immagini in parallelo
- 600 letture / min
- 60 richieste di creazione / min
- 20 immagini in parallelo
- 1,200 letture / min
Domande e risposte.
Cosa chiedono gli sviluppatori prima di collegare Garmo a uno shop o a un flusso di lavoro.
Dubbi? ScriviciQuanto costa l'API AI?
L'API funziona con pacchetti di crediti acquistati dalla pagina API di Garmo Studio, senza abbonamento. Un credito è un'immagine, un upscale 4K ne vale due. Pacchetti e prezzo per immagine sono qui sopra.
Posso provarla gratis?
Sì. Crea una chiave di test nella pagina API: chiama ogni endpoint, restituisce la tua foto come risultato e non consuma crediti. Le chiavi live richiedono un pacchetto API.
Bastano una foto e un prompt?
Sì. POST /generate riceve una foto prodotto e un prompt con parole tue, e crea fino a quattro nuove foto. Aggiungi una modella e il prodotto viene indossato.
L'API è separata dall'abbonamento Garmo?
Sì. L'API usa solo crediti API; i crediti Studio e gli abbonamenti non valgono per l'API, e viceversa.
Quanto tempo serve per un'immagine?
La richiesta risponde in circa due secondi. Le immagini arrivano di solito in 20–90 secondi, a seconda della modifica e del carico.
Di chi sono le immagini?
Tue, come quelle create in Garmo Studio: usale a fini commerciali nel tuo shop, sui marketplace e nelle pubblicità. I risultati dell’API non hanno filigrana.
La documentazione è in italiano?
La documentazione tecnica è in inglese: nomi dei parametri, codici di errore ed esempi di codice lo sono già, e manteniamo un'unica fonte aggiornata. Puoi scriverci in italiano a support@garmo.studio.
Ottieni una chiave API
Le chiavi di test sono gratuite e non richiedono pacchetti.




