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.

Robe d’été terracotta à volants posée à plat sur un parquet
Entrée
Une mannequin portant la robe terracotta sous une colonnade en pierre
Front
La même mannequin marchant avec la robe
Walking
POST https://api.garmo.studio/v1/generate
{
  "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.

Comment ç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.

  1. 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_••••••••
  2. 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
  3. 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
  4. 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
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
}

Tous les codes d'erreur →400401402403404409413429500503

Votre agent de code
Claude CodeCodexCursor
GarmoAPI
Lis https://garmo.studio/api/docs/generate.md, puis crée trois photos portées de ./robe.jpg et enregistre-les dans ./photos

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

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

Guide des agents (en anglais) → · SKILL.md

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

API 60$960 crédits API$0.15 par image
  • 10 requêtes de création / min
  • 3 images en parallèle
  • 120 lectures / min
API 220$19220 crédits API$0.086 par image42 % de moins par image
  • 20 requêtes de création / min
  • 6 images en parallèle
  • 300 lectures / min
API 700$49700 crédits API$0.07 par image53 % de moins par image
  • 40 requêtes de création / min
  • 10 images en parallèle
  • 600 lectures / min
Meilleur prixAPI 3500$1993,500 crédits API$0.057 par image62 % de moins par image
  • 60 requêtes de création / min
  • 20 images en parallèle
  • 1,200 lectures / min
Bon à savoir

Vos questions, nos réponses.

Ce que les développeurs demandent avant de brancher Garmo à une boutique ou à un workflow.

Une question ? Écrivez-nous

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