API Garmo
L'API IA pour les photos de mode et les photos produit
Garmo Studio en HTTP : envoyez une photo produit et un prompt pour obtenir de nouvelles photos produit ou portées, ou retouchez vos photos : coloris, poses, mannequins, fonds et 4K. Pensée pour les vêtements, chaussures, sacs et bijoux, avec le même compte que l'application.
Les clés de test sont gratuites et sans pack. La documentation technique est en anglais.



{
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}Créer et retoucher, une seule API
Chaque endpoint fait une chose et la fait bien, sans toucher au produit : couleur, matière, imprimé, logo et coutures restent intacts.
Avant
AprèsAPI shooting photo produitUne photo produit et un prompt : de nouvelles photos, portées ou non.POST /generate
Avant
AprèsAPI changement de couleur de vêtementTous les coloris à partir d’une photo, au code hex près.POST /edit/color
Avant
AprèsAPI changement de poseLa vue de dos et la photo en marche à partir d’une photo.POST /edit/pose
Avant
AprèsAPI changement de mannequinLa même tenue et la même pose sur un autre mannequin.POST /edit/model-swap
Avant
AprèsAPI mannequin invisibleL’effet mannequin invisible, sans mannequin.POST /edit/ghost-mannequin
Avant
AprèsAPI changement de fondLe produit reste, le lieu et la lumière changent.POST /edit/background
Avant
AprèsAPI détourageProduit détouré sur transparent, blanc ou votre couleur.POST /edit/remove-background
Avant
AprèsAPI agrandissement d’imagePhotos produit en 2K ou 4K, avec le détail des matières.POST /edit/upscaleComment ça marche, étape par étape
De la clé à l'image finie en quatre étapes. Votre code n'attend jamais : Garmo travaille en arrière-plan et vous prévient quand les images sont prêtes.
- 01
Créez une clé
Dans Garmo Studio, ouvrez Développeurs › API et créez une clé. Une clé de test est gratuite et renvoie votre propre photo comme résultat : vous montez toute l’intégration avant d’acheter.
gm_test_•••••••• - 02
Envoyez la photo
Envoyez la photo produit (une URL, le fichier ou un identifiant d’upload) en POST avec un prompt, ou à un endpoint d’édition avec ses paramètres.
POST /generate - 03
Recevez un job tout de suite
La réponse arrive en deux secondes environ, avec l’identifiant du job et le statut processing. Garmo produit les images en 20 à 90 secondes.
202 · processing - 04
Récupérez les images
Un webhook signé arrive à la fin du job, ou vous interrogez GET /jobs/{id}. Chaque image est un lien de téléchargement valable un jour ; une image ratée est recréditée.
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"
}
}Tous les codes d'erreur →400401402403404409413429500503
Fonctionne aussi avec Gemini CLI, GitHub Copilot et tout agent capable d’appeler une API.
Agents de code
Utilisez Garmo depuis Claude Code, Codex et Cursor
Votre agent trouve vos photos produit, transmet la demande et enregistre les images finies dans votre dossier. Vous décrivez ce que vous voulez, sans écrire une ligne de code.
Chaque page de la documentation existe aussi en Markdown : n’importe quel agent peut la lire et créer les images à partir de votre prompt. Ou installez une fois le skill Garmo, puis demandez simplement.
Installer le skill pour Claude Code, Codex et 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"
donePourquoi Garmo
Pensée pour la mode
Les consignes derrière chaque endpoint sont réglées pour les vêtements et les produits : le satin garde son reflet après un changement de couleur, l’imprimé reste en place après un changement de pose.
Un seul compte, Studio et API
Le même compte Garmo fonctionne dans Studio et via l’API, et les jobs de l’API apparaissent dans votre bibliothèque Studio.
Clés de test gratuites
Une clé gm_test_ appelle tous les endpoints gratuitement et renvoie votre propre photo comme résultat. Vous construisez tout avant de payer.
Prête pour la production
Clés d’idempotence, webhooks signés relancés automatiquement et codes d’erreur clairs. Une image ratée rend son crédit toute seule.
Ce que l’on construit avec
Synchroniser un catalogue
Nouveau produit dans la boutique → une image par coloris et une version sur fond blanc, réécrites sur la fiche produit.
Automatisations no-code
Appelez l’API depuis n8n, Make ou Zapier avec une simple étape HTTP ; le webhook déclenche la suite.
Annonces sur les marketplaces
Mannequin invisible et agrandissement pour chaque photo avant sa mise en ligne.
Packs de crédits API
Achats ponctuels sur la page API de Garmo Studio. Les crédits API sont distincts des crédits Studio et des abonnements.
- 10 requêtes de création / min
- 3 images en parallèle
- 120 lectures / min
- 20 requêtes de création / min
- 6 images en parallèle
- 300 lectures / min
- 40 requêtes de création / min
- 10 images en parallèle
- 600 lectures / min
- 60 requêtes de création / min
- 20 images en parallèle
- 1,200 lectures / min
Vos questions, nos réponses.
Ce que les développeurs demandent avant de brancher Garmo à une boutique ou à un workflow.
Une question ? Écrivez-nousCombien coûte l’API IA ?
L’API fonctionne avec des packs de crédits achetés sur la page API de Garmo Studio, sans abonnement. Un crédit correspond à une image (deux pour un agrandissement 4K). Les packs et le prix par image sont ci-dessus.
Peut-on l’essayer gratuitement ?
Oui. Créez une clé de test sur la page API : elle appelle tous les endpoints, renvoie votre propre photo comme résultat et ne consomme aucun crédit. Une clé live nécessite un pack API.
Une photo et un prompt suffisent ?
Oui. POST /generate prend une photo produit et un prompt écrit avec vos mots, et crée jusqu’à quatre nouvelles photos. Ajoutez un mannequin et le produit est porté.
L’API est-elle séparée de l’abonnement Garmo ?
Oui. L’API ne consomme que des crédits API ; les crédits Studio et les abonnements ne servent pas à l’API, et inversement.
Combien de temps prend une image ?
La requête répond en deux secondes environ. Les images arrivent en général en 20 à 90 secondes selon la retouche et la charge.
À qui appartiennent les images ?
À vous, comme pour les images créées dans Garmo Studio : utilisez-les commercialement sur votre boutique, les marketplaces et vos publicités. Les résultats de l’API n’ont pas de filigrane.
La documentation est-elle en français ?
La documentation technique est en anglais : les noms de paramètres, les codes d’erreur et les exemples de code le sont déjà, et nous gardons une seule source à jour. Vous pouvez nous écrire en français : support@garmo.studio.
Obtenir une clé API
Les clés de test sont gratuites et sans pack.




