API de Garmo
La API de IA para imágenes de moda y de producto
Garmo Studio por HTTP: envía una foto de producto y un prompt para obtener nuevas fotos de producto o con modelo, o edita las fotos que ya tienes: colores, poses, modelos, fondos y 4K. Hecha para ropa, calzado, bolsos y joyas, con la misma cuenta que la app.
Las claves de prueba son gratis y no necesitan paquete. La documentación técnica está en inglés.



{
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}Crea y edita, una sola API
Cada endpoint hace una cosa bien y deja el producto tal cual: color, tejido, estampado, logo y costuras.
Antes
DespuésAPI de sesión de fotos de productoUna foto de producto y un prompt: fotos nuevas, con modelo o sin ella.POST /generate
Antes
DespuésAPI para cambiar el color de la ropaTodas las variantes de color desde una foto, al código hex exacto.POST /edit/color
Antes
DespuésAPI para cambiar la poseLa vista de espalda y la foto caminando desde una sola foto.POST /edit/pose
Antes
DespuésAPI para cambiar de modeloEl mismo look y la misma pose en otra modelo.POST /edit/model-swap
Antes
DespuésAPI de maniquí invisibleEl efecto maniquí invisible, sin maniquí.POST /edit/ghost-mannequin
Antes
DespuésAPI para cambiar el fondoEl producto se queda; cambian el lugar y la luz.POST /edit/background
Antes
DespuésAPI para quitar el fondoRecorta el producto sobre transparente, blanco o tu color.POST /edit/remove-background
Antes
DespuésAPI para mejorar la calidad de imagenFotos de producto en 2K o 4K con detalle real del material.POST /edit/upscaleCómo funciona, paso a paso
De la clave a la imagen terminada en cuatro pasos. Tu código nunca espera: Garmo trabaja en segundo plano y te avisa cuando las imágenes están listas.
- 01
Crea una clave
En Garmo Studio, abre Desarrolladores › API y crea una clave. La clave de prueba es gratis y devuelve tu propia foto como resultado, así montas toda la integración antes de pagar.
gm_test_•••••••• - 02
Envía la foto
Envía la foto del producto (una URL, el archivo o un id de subida) por POST con un prompt, o a un endpoint de edición con sus parámetros.
POST /generate - 03
Recibe un job al instante
La respuesta llega en unos dos segundos con el id del job y el estado processing. Garmo genera las imágenes en 20 a 90 segundos.
202 · processing - 04
Recibe las imágenes
Llega un webhook firmado cuando el job termina, o consultas GET /jobs/{id}. Cada imagen es un enlace de descarga válido un día; una imagen fallida devuelve su crédito.
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"
}
}Todos los códigos de error →400401402403404409413429500503
También funciona con Gemini CLI, GitHub Copilot y cualquier agente que pueda llamar a una API.
Agentes de código
Usa Garmo desde Claude Code, Codex y Cursor
Tu agente encuentra tus fotos de producto, envía el encargo y guarda las imágenes terminadas en tu carpeta. Tú describes lo que quieres, sin escribir código.
Cada página de la documentación está también en Markdown, así que cualquier agente puede leerla y crear imágenes a partir de tu prompt. O instala una vez el skill de Garmo y simplemente pide.
Instala el skill para Claude Code, Codex y 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"
donePor qué Garmo
Hecha para moda
Las instrucciones de cada endpoint están ajustadas a prendas y productos: el satén conserva su brillo al cambiar de color y el estampado sigue en su sitio al cambiar de pose.
Una cuenta para Studio y API
La misma cuenta de Garmo funciona en Studio y por API, y los jobs de la API aparecen en tu biblioteca de Studio.
Claves de prueba gratis
Una clave gm_test_ llama a todos los endpoints gratis y devuelve tu propia foto como resultado. Construyes todo antes de comprar nada.
Lista para producción
Claves de idempotencia, webhooks firmados con reintentos y códigos de error claros. Una imagen fallida devuelve su crédito sola.
Qué se construye con ella
Sincronizar el catálogo
Producto nuevo en la tienda → una imagen por variante de color y otra sobre fondo blanco, guardadas en la ficha.
Flujos sin código
Llámala desde n8n, Make o Zapier con un simple paso HTTP; el webhook lanza el paso siguiente.
Anuncios en marketplaces
Maniquí invisible y escalado para cada foto antes de publicarla.
Paquetes de créditos de API
Compras únicas en la página API de Garmo Studio. Los créditos de API son distintos de los créditos de Studio y de las suscripciones.
- 10 peticiones de creación / min
- 3 imágenes a la vez
- 120 consultas / min
- 20 peticiones de creación / min
- 6 imágenes a la vez
- 300 consultas / min
- 40 peticiones de creación / min
- 10 imágenes a la vez
- 600 consultas / min
- 60 peticiones de creación / min
- 20 imágenes a la vez
- 1,200 consultas / min
Preguntas y respuestas.
Lo que preguntan los desarrolladores antes de conectar Garmo a una tienda o a un flujo de trabajo.
¿Alguna duda? Escríbenos¿Cuánto cuesta la API de IA?
La API funciona con paquetes de créditos que se compran en la página API de Garmo Studio, sin suscripción. Un crédito es una imagen; un escalado a 4K son dos. Arriba tienes los paquetes y el precio por imagen.
¿Puedo probarla gratis?
Sí. Crea una clave de prueba en la página API: llama a todos los endpoints, devuelve tu propia foto como resultado y no gasta créditos. Las claves live necesitan un paquete de API.
¿Basta con una foto y un prompt?
Sí. POST /generate recibe una foto de producto y un prompt con tus palabras, y crea hasta cuatro fotos nuevas. Añade una modelo y el producto aparece puesto.
¿La API es independiente de la suscripción de Garmo?
Sí. La API solo gasta créditos de API; los créditos de Studio y las suscripciones no se usan en la API, ni al revés.
¿Cuánto tarda una imagen?
La petición responde en unos dos segundos. Las imágenes suelen llegar en 20 a 90 segundos, según la edición y la carga.
¿De quién son las imágenes?
Tuyas, como las que creas en Garmo Studio: úsalas con fines comerciales en tu tienda, marketplaces y anuncios. Los resultados de la API no llevan marca de agua.
¿La documentación está en español?
La documentación técnica está en inglés: los nombres de parámetros, los códigos de error y los ejemplos de código ya lo están, y mantenemos una sola fuente actualizada. Puedes escribirnos en español a support@garmo.studio.
Obtener una clave API
Las claves de prueba son gratis y no necesitan paquete.




