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.

Ahşap zemine serilmiş kiremit rengi kat kat askılı elbise
Girdi
Kiremit rengi elbiseyi taş sütunlu bir revakta giyen manken
Front
Aynı manken elbiseyle yürürken
Walking
POST https://api.garmo.studio/v1/generate
{
  "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ş.

Nası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.

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

Tüm hata kodları →400401402403404409413429500503

Kodlama asistanınız
Claude CodeCodexCursor
GarmoAPI
https://garmo.studio/api/docs/generate.md dosyasını oku, sonra ./elbise.jpg için üç mankenli fotoğraf üret ve ./fotograflar klasörüne kaydet

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

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

Asistan rehberi (İngilizce) → · SKILL.md

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

API 60$960 API kredisi$0.15 görsel başına
  • 10 üretim isteği / dk
  • 3 aynı anda görsel
  • 120 okuma / dk
API 220$19220 API kredisi$0.086 görsel başınaGörsel başı %42 daha ucuz
  • 20 üretim isteği / dk
  • 6 aynı anda görsel
  • 300 okuma / dk
API 700$49700 API kredisi$0.07 görsel başınaGörsel başı %53 daha ucuz
  • 40 üretim isteği / dk
  • 10 aynı anda görsel
  • 600 okuma / dk
En avantajlıAPI 3500$1993,500 API kredisi$0.057 görsel başınaGörsel başı %62 daha ucuz
  • 60 üretim isteği / dk
  • 20 aynı anda görsel
  • 1,200 okuma / dk
Bilmekte fayda var

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ın

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