Garmo API
Moda ve ürün fotoğrafları için yapay zeka API'si
Garmo Studio'yu kendi kodunuzdan çağırın: bir ürün fotoğrafı ve prompt gönderin, yeni ürün ya da mankenli fotoğraflar alın; elinizdeki fotoğrafları da düzenleyin: renk varyantı, poz, manken, arka plan ve 4K. Giyim, ayakkabı, çanta ve takı için yapıldı; hesabınız Studio ile aynı.
Test anahtarı ücretsizdir, paket gerektirmez. Teknik doküman İngilizcedir.



{
"model": "auto",
"prompt": "a sunlit stone colonnade, warm late-afternoon light",
"count": 2
}Üret ve düzenle, tek API
Her uç nokta tek bir işi iyi yapar ve ürünü olduğu gibi korur: renk, kumaş, desen, logo ve dikiş.
Önce
SonraÜrün çekimi API'siBir ürün fotoğrafı ve prompt verin; mankenli ya da mankensiz yeni fotoğraflar alın.POST /generate
Önce
SonraKıyafet rengi değiştirme API'siTek fotoğraftan her renk varyantı, tam hex koduyla.POST /edit/color
Önce
SonraPoz değiştirme API'siTek fotoğraftan arka görünüm ve yürüyüş karesi.POST /edit/pose
Önce
SonraManken değiştirme API'siAynı kıyafet ve poz, başka bir mankende.POST /edit/model-swap
Önce
SonraHayalet manken API'siMankeni görünmeyen, içi boş ürün çekimi.POST /edit/ghost-mannequin
Önce
SonraArka plan değiştirme API'siÜrün aynı kalır; mekân ve ışık değişir.POST /edit/background
Önce
SonraArka plan silme API'siÜrünü şeffaf, beyaz ya da marka renginize keser.POST /edit/remove-background
Önce
SonraGörsel büyütme API'siMalzeme detayıyla 2K veya 4K ürün fotoğrafı.POST /edit/upscaleNasıl çalışır, adım adım
Anahtardan bitmiş görsele dört adım. Kodunuz hiç beklemez: Garmo arka planda çalışır, görseller hazır olunca size haber verir.
- 01
Anahtar oluşturun
Garmo Studio'da Geliştiriciler › API sayfasını açın ve bir anahtar oluşturun. Test anahtarı ücretsizdir ve sonuç olarak kendi fotoğrafınızı döndürür; entegrasyonu önce onunla kurarsınız.
gm_test_•••••••• - 02
Fotoğrafı gönderin
Ürün fotoğrafını (bir URL, dosyanın kendisi ya da yükleme kimliği) bir prompt ile POST edin ya da bir düzenleme uç noktasına parametreleriyle gönderin.
POST /generate - 03
Hemen iş kimliği alın
Yanıt yaklaşık iki saniyede gelir: bir iş kimliği ve processing durumu. Garmo görselleri 20–90 saniyede üretir.
202 · processing - 04
Görselleri teslim alın
İş bitince imzalı bir webhook gelir ya da GET /jobs/{id} ile kontrol edersiniz. Her görsel bir gün geçerli bir indirme bağlantısıdır; üretilemeyen görselin kredisi iade edilir.
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"
}
}Tüm hata kodları →400401402403404409413429500503
Gemini CLI, GitHub Copilot ve API çağırabilen her asistanla da çalışır.
Kodlama asistanları
Garmo'yu Claude Code, Codex ve Cursor'dan kullanın
Kodlama asistanınız ürün fotoğraflarınızı bulur, ne istediğinizi Garmo’ya iletir ve hazır görselleri klasörünüze kaydeder. Siz yalnızca ne istediğinizi yazarsınız; tek satır kod gerekmez.
Her doküman sayfasının Markdown hâli de var; her asistan okuyup isteğinize göre görsel üretebilir. Ya da Garmo skill’ini bir kez kurun, sonrasında sadece isteyin.
Skill’i Claude Code, Codex ve Cursor için kurun
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"
doneNeden Garmo
Moda için yapıldı
Her uç noktanın arkasındaki talimatlar giysi ve ürün için ayarlandı: renk değişince satenin parlaklığı, poz değişince desen yerinde kalır.
Studio ve API için tek hesap
Aynı Garmo hesabı Studio'da da API'de de çalışır; API ile yapılan işler Studio kitaplığınızda görünür.
Test anahtarı ücretsiz
gm_test_ anahtarı her uç noktayı ücretsiz çalıştırır ve sonuç olarak kendi fotoğrafınızı döndürür. Hiçbir şey satın almadan entegrasyonu baştan sona kurarsınız.
Hatalara karşı sağlam
Idempotency anahtarları, tekrar denenen imzalı webhook'lar ve net hata kodları. Üretilemeyen görselin kredisi kendiliğinden geri döner.
Neler kuruluyor
Mağaza kataloğu senkronu
Katalogda yeni ürün açılınca her varyant için renk görseli ve beyaz arka planlı bir görsel üretilir, ürüne geri yazılır.
Kodsuz otomasyonlar
n8n, Make ya da Zapier'da tek bir HTTP adımıyla çağırın; webhook bir sonraki adımı başlatır.
Pazaryeri ilanları
Her ilan fotoğrafı pazaryerine gitmeden önce hayalet manken ve büyütmeden geçer.
API kredi paketleri
Garmo Studio'daki API sayfasından tek seferlik alınır. API kredisi, Studio kredisinden ve aboneliklerden ayrıdır.
- 10 üretim isteği / dk
- 3 aynı anda görsel
- 120 okuma / dk
- 20 üretim isteği / dk
- 6 aynı anda görsel
- 300 okuma / dk
- 40 üretim isteği / dk
- 10 aynı anda görsel
- 600 okuma / dk
- 60 üretim isteği / dk
- 20 aynı anda görsel
- 1,200 okuma / dk
Sorular ve cevaplar.
Garmo’yu bir mağazaya ya da iş akışına bağlamadan önce geliştiricilerin sorduğu sorular.
Takıldınız mı? Bize yazınYapay zeka API fiyatları nasıl?
API, Garmo Studio’daki API sayfasından alınan kredi paketleriyle çalışır; abonelik gerekmez. Bir kredi bir görseldir, 4K büyütme iki kredidir. Paketler ve görsel başına fiyat yukarıda.
Ücretsiz deneyebilir miyim?
Evet. API sayfasında bir test anahtarı oluşturun: her uç noktayı çağırır, sonuç olarak kendi fotoğrafınızı döndürür ve hiç kredi harcamaz. Canlı anahtar için bir API paketi gerekir.
Sadece fotoğraf ve prompt göndersem olur mu?
Evet. POST /generate tek bir ürün fotoğrafı ve kendi cümlelerinizle yazdığınız bir prompt alır, dört taneye kadar yeni fotoğraf üretir. Manken eklerseniz ürün mankene giydirilir.
API, Garmo aboneliğinden ayrı mı?
Evet. API yalnızca API kredisi harcar; Studio kredileri ve abonelikler API’de kullanılmaz, API kredisi de Studio’da kullanılmaz.
Bir görsel ne kadar sürer?
İstek yaklaşık iki saniyede yanıtlanır. Görseller düzenlemeye ve yoğunluğa göre genellikle 20–90 saniyede gelir.
Üretilen görsellerin hakları kimde?
Sizde; Studio’da ürettiğiniz görseller gibi mağazanızda, pazaryerlerinde ve reklamlarda ticari olarak kullanabilirsiniz. API sonuçlarında filigran yoktur.
Doküman Türkçe mi?
Teknik doküman İngilizcedir: parametre adları, hata kodları ve kod örnekleri zaten İngilizce olduğu için tek ve güncel bir kaynak tutuyoruz. Sorularınızı Türkçe sorabilirsiniz: support@garmo.studio.
API anahtarı alın
Test anahtarı ücretsizdir, paket gerektirmez.




