Garmo API

The AI image editing API for fashion and product photos

Garmo Studio over HTTP: send a product photo and a prompt to get new product or on-model photos, or edit the photos you have: colorways, poses, models, backgrounds and 4K. Made for clothing, shoes, bags and jewelry, with the same account as the app.

Test keys are free and need no pack.

Terracotta tiered sundress laid flat on a wooden floor
Input
A model wearing the terracotta sundress in a stone colonnade
Front
The same model walking in the sundress
Walking
POST https://api.garmo.studio/v1/generate
{
  "model": "auto",
  "prompt": "a sunlit stone colonnade, warm late-afternoon light",
  "count": 2
}

Generate and edit, one API

Each endpoint does one job well and keeps the product exactly as it is: color, fabric, print, logo and stitching.

How it works, step by step

From key to finished image in four steps. Your code never waits: Garmo works in the background and tells you when the images are ready.

  1. 01

    Create a key

    In Garmo Studio, open Developers › API and create a key. A test key is free and returns your own photo as the result, so you can build everything first.

    gm_test_••••••••
  2. 02

    Send the photo

    POST the product photo (a URL, the file or an upload id) with a prompt, or to an edit endpoint with its parameters.

    POST /generate
  3. 03

    Get a job id at once

    The answer comes in about two seconds with a job id and the status processing. Garmo makes the images in 20 to 90 seconds.

    202 · processing
  4. 04

    Receive the images

    A signed webhook arrives when the job is done, or you check GET /jobs/{id}. Each image is a download link valid for a day; a failed image gives its credit back.

    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
}

All error codes →400401402403404409413429500503

Your coding agent
Claude CodeCodexCursor
GarmoAPI
Read https://garmo.studio/api/docs/generate.md, then make three on-model photos of ./dress.jpg and save them in ./photos

Also works with Gemini CLI, GitHub Copilot and any agent that can call an API.

Coding agents

Use Garmo from Claude Code, Codex and Cursor

Your coding agent finds your product photos, sends the brief and saves the finished images in your folder. You describe what you want; you do not write any code.

Every docs page is also Markdown, so any agent can read it and make images from your prompt. Or install the Garmo skill once and just ask.

Install the skill for Claude Code, Codex and 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

Agent guide (English) → · SKILL.md

Why build on Garmo

Made for fashion

Every prompt behind the endpoints is tuned for garments and products, so a recolor keeps the satin sheen and a new pose keeps the print.

One account for Studio and API

The same Garmo account works in Studio and through the API, and jobs made by the API show up in your Studio library.

Test keys cost nothing

A gm_test_ key runs every endpoint for free and returns your own photo as a stand-in result, so you can build the whole integration before buying anything.

Built to be retried

Idempotency keys, signed webhooks with retries, and clear error codes. A failed image gives its credit back by itself.

What people build with it

Shop catalog sync

New product in the catalog → recolor for every variant and a clean white image, written back to the product.

No-code workflows

Call it from n8n, Make or Zapier with a plain HTTP step; the webhook feeds the next step.

Marketplace listings

Ghost mannequin and upscale for every listing photo before it goes to the marketplace.

API credit packs

One-time purchases on the API page in Garmo Studio. API credits are separate from Studio credits and subscriptions.

API 60$960 API credits$0.15 per image
  • 10 create requests / min
  • 3 images at once
  • 120 reads / min
API 220$19220 API credits$0.086 per image42% less per image
  • 20 create requests / min
  • 6 images at once
  • 300 reads / min
API 700$49700 API credits$0.07 per image53% less per image
  • 40 create requests / min
  • 10 images at once
  • 600 reads / min
Best valueAPI 3500$1993,500 API credits$0.057 per image62% less per image
  • 60 create requests / min
  • 20 images at once
  • 1,200 reads / min

API pricing →

Good to know

Questions, answered.

What developers ask before connecting Garmo to a shop or a workflow.

Still stuck? Email us

Is the API separate from a Garmo subscription?

Yes. The API uses API credits, bought in packs on the API page in Garmo Studio. Studio credits and subscriptions are not used by the API, and API credits are not used in Studio.

Can I try it before paying?

Yes. Create a test key on the API page: it calls every endpoint, returns your own photo as a stand-in result and spends nothing. Live keys need an API pack.

Can I just send a photo and a prompt?

Yes. POST /generate takes one product photo and a prompt in your own words and makes up to four new photos. Add a model and the product is worn.

How long does an image take?

The request returns in about two seconds. The images usually follow in 20 to 90 seconds, depending on the edit and the load.

Who owns the results?

You do, as with images made in Garmo Studio: use them commercially on your shop, marketplaces and ads. API results have no watermark.

Do I need to host my images?

No. Send a public https URL, the image as base64, or upload it once with POST /uploads and use the upload id.

Is there documentation?

Yes: a getting-started guide, every endpoint with its parameters and examples in cURL, Python, Node.js and PHP, webhooks, errors and rate limits, plus an OpenAPI 3.1 file for code generators.

Get an API key

Test keys are free and need no pack.