Garmo API
Die KI-API für Mode- und Produktfotos
Garmo Studio per HTTP: Produktfoto und Prompt senden und neue Produkt- oder Modelfotos bekommen, oder vorhandene Fotos bearbeiten: Farbvarianten, Posen, Models, Hintergründe und 4K. Gemacht für Kleidung, Schuhe, Taschen und Schmuck, mit demselben Konto wie die App.
Testschlüssel sind kostenlos und brauchen kein Paket. Die technische Dokumentation ist auf Englisch.



{
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}Erzeugen und bearbeiten, eine API
Jeder Endpunkt macht eine Sache richtig und lässt das Produkt, wie es ist: Farbe, Stoff, Muster, Logo und Nähte.
Vorher
NachherProduktshooting-APIEin Produktfoto und ein Prompt rein, neue Fotos raus, mit oder ohne Model.POST /generate
Vorher
NachherAPI: Kleidungsfarbe ändernJede Farbvariante aus einem Foto, auf den Hex-Code genau.POST /edit/color
Vorher
NachherAPI: Pose ändernRückansicht und Laufbild aus einem Foto.POST /edit/pose
Vorher
NachherAPI: Model austauschenDasselbe Outfit und dieselbe Pose an einem anderen Model.POST /edit/model-swap
Vorher
NachherGhost-Mannequin-APIDer Unsichtbare-Puppe-Look, ganz ohne Puppe.POST /edit/ghost-mannequin
Vorher
NachherAPI: Hintergrund ändernDas Produkt bleibt, Ort und Licht ändern sich.POST /edit/background
Vorher
NachherAPI: Hintergrund entfernenFreisteller auf transparent, Weiß oder Ihrer Markenfarbe.POST /edit/remove-background
Vorher
NachherAPI: Bild hochskalierenProduktfotos in 2K oder 4K mit echtem Materialdetail.POST /edit/upscaleSo funktioniert es, Schritt für Schritt
Vom Schlüssel zum fertigen Bild in vier Schritten. Ihr Code wartet nie: Garmo arbeitet im Hintergrund und meldet sich, wenn die Bilder fertig sind.
- 01
Schlüssel anlegen
Öffnen Sie in Garmo Studio Entwickler › API und legen Sie einen Schlüssel an. Ein Testschlüssel ist kostenlos und liefert Ihr eigenes Foto als Ergebnis, so bauen Sie die ganze Integration vorab.
gm_test_•••••••• - 02
Foto senden
Senden Sie das Produktfoto (URL, Datei oder Upload-ID) per POST mit einem Prompt, oder an einen Bearbeitungs-Endpunkt mit dessen Parametern.
POST /generate - 03
Sofort eine Job-ID
Die Antwort kommt nach etwa zwei Sekunden mit Job-ID und Status processing. Garmo erzeugt die Bilder in 20 bis 90 Sekunden.
202 · processing - 04
Bilder empfangen
Ein signierter Webhook kommt, sobald der Job fertig ist, oder Sie fragen GET /jobs/{id} ab. Jedes Bild ist ein Download-Link, einen Tag gültig; ein fehlgeschlagenes Bild gibt seinen Credit zurück.
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"
}
}Alle Fehlercodes →400401402403404409413429500503
Funktioniert auch mit Gemini CLI, GitHub Copilot und jedem Agent, der eine API aufrufen kann.
Coding-Agents
Garmo aus Claude Code, Codex und Cursor nutzen
Ihr Coding-Agent findet Ihre Produktfotos, schickt den Auftrag und speichert die fertigen Bilder in Ihrem Ordner. Sie beschreiben, was Sie wollen, ohne eine Zeile Code.
Jede Seite der Dokumentation gibt es auch als Markdown, so kann jeder Agent sie lesen und Bilder nach Ihrem Prompt erzeugen. Oder Sie installieren einmal den Garmo-Skill und fragen einfach.
Skill für Claude Code, Codex und Cursor installieren
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"
doneWarum Garmo
Für Mode gemacht
Die Anweisungen hinter jedem Endpunkt sind auf Kleidung und Produkte abgestimmt: Satin behält beim Umfärben seinen Glanz, das Muster bleibt bei neuer Pose an seinem Platz.
Ein Konto für Studio und API
Dasselbe Garmo-Konto funktioniert in Studio und über die API, und Jobs aus der API erscheinen in Ihrer Studio-Bibliothek.
Testschlüssel kostenlos
Ein gm_test_-Schlüssel ruft jeden Endpunkt kostenlos auf und liefert Ihr eigenes Foto als Ergebnis. Sie bauen alles, bevor Sie etwas kaufen.
Robust im Betrieb
Idempotency-Keys, signierte Webhooks mit Wiederholungen und klare Fehlercodes. Ein fehlgeschlagenes Bild gibt seinen Credit von selbst zurück.
Was damit gebaut wird
Katalog-Sync für Shops
Neues Produkt im Shop → ein Bild pro Farbvariante und eines auf Weiß, zurück ins Produkt geschrieben.
No-Code-Workflows
Aus n8n, Make oder Zapier mit einem einfachen HTTP-Schritt aufrufen; der Webhook startet den nächsten Schritt.
Marktplatz-Angebote
Ghost Mannequin und Hochskalieren für jedes Angebotsfoto, bevor es online geht.
API-Credit-Pakete
Einmalkäufe auf der API-Seite in Garmo Studio. API-Credits sind getrennt von Studio-Credits und Abos.
- 10 Erstell-Anfragen / Min.
- 3 Bilder gleichzeitig
- 120 Abfragen / Min.
- 20 Erstell-Anfragen / Min.
- 6 Bilder gleichzeitig
- 300 Abfragen / Min.
- 40 Erstell-Anfragen / Min.
- 10 Bilder gleichzeitig
- 600 Abfragen / Min.
- 60 Erstell-Anfragen / Min.
- 20 Bilder gleichzeitig
- 1,200 Abfragen / Min.
Fragen und Antworten.
Was Entwickler fragen, bevor sie Garmo mit einem Shop oder Workflow verbinden.
Noch Fragen? Schreiben Sie unsWas kostet die KI-API?
Die API läuft mit Credit-Paketen von der API-Seite in Garmo Studio, ganz ohne Abo. Ein Credit ist ein Bild, ein 4K-Upscale zwei. Pakete und Preis pro Bild stehen oben.
Kann ich sie kostenlos testen?
Ja. Legen Sie auf der API-Seite einen Testschlüssel an: Er ruft jeden Endpunkt auf, liefert Ihr eigenes Foto als Ergebnis und verbraucht keine Credits. Live-Schlüssel brauchen ein API-Paket.
Reichen ein Foto und ein Prompt?
Ja. POST /generate nimmt ein Produktfoto und einen Prompt in Ihren eigenen Worten und erzeugt bis zu vier neue Fotos. Mit einem Model wird das Produkt getragen.
Ist die API vom Garmo-Abo getrennt?
Ja. Die API verbraucht nur API-Credits; Studio-Credits und Abos gelten nicht für die API und umgekehrt.
Wie lange dauert ein Bild?
Die Anfrage antwortet nach etwa zwei Sekunden. Die Bilder folgen meist nach 20 bis 90 Sekunden, je nach Bearbeitung und Auslastung.
Wem gehören die Bilder?
Ihnen, wie bei Bildern aus Garmo Studio: Nutzen Sie sie kommerziell im Shop, auf Marktplätzen und in Anzeigen. API-Ergebnisse haben kein Wasserzeichen.
Gibt es die Dokumentation auf Deutsch?
Die technische Dokumentation ist auf Englisch: Parameternamen, Fehlercodes und Codebeispiele sind es ohnehin, und wir halten eine einzige, aktuelle Quelle. Fragen gern auf Deutsch an support@garmo.studio.
API-Schlüssel holen
Testschlüssel sind kostenlos und brauchen kein Paket.




