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.

Abito a balze color terracotta steso su un pavimento di legno
Input
Una modella con l’abito terracotta sotto un porticato di pietra
Front
La stessa modella che cammina con l’abito
Walking
POST https://api.garmo.studio/v1/generate
{
  "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.

Come 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.

  1. 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_••••••••
  2. 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
  3. 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
  4. 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
POST api.garmo.studio/v1/generate
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
  }'
{
  "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
}

Tutti i codici di errore →400401402403404409413429500503

Il tuo agente di coding
Claude CodeCodexCursor
GarmoAPI
Leggi https://garmo.studio/api/docs/generate.md, poi crea tre foto indossate di ./abito.jpg e salvale in ./foto

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

Shell
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"
done

Guida per agenti (in inglese) → · SKILL.md

Perché 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.

API 60$960 crediti API$0.15 per immagine
  • 10 richieste di creazione / min
  • 3 immagini in parallelo
  • 120 letture / min
API 220$19220 crediti API$0.086 per immagine42% in meno per immagine
  • 20 richieste di creazione / min
  • 6 immagini in parallelo
  • 300 letture / min
API 700$49700 crediti API$0.07 per immagine53% in meno per immagine
  • 40 richieste di creazione / min
  • 10 immagini in parallelo
  • 600 letture / min
Più convenienteAPI 3500$1993,500 crediti API$0.057 per immagine62% in meno per immagine
  • 60 richieste di creazione / min
  • 20 immagini in parallelo
  • 1,200 letture / min
Buono a sapersi

Domande e risposte.

Cosa chiedono gli sviluppatori prima di collegare Garmo a uno shop o a un flusso di lavoro.

Dubbi? Scrivici

Quanto 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.