Gamma API nedir?
Sevdiğiniz bir sunumunuz mu var? Peki ya dünyanın farklı kitleleri için kişiselleştirilmiş 100 tane daha oluşturabilseydiniz?
Gamma Oluştur API, Gamma uygulamasını doğrudan kullanmadan programlı olarak sunumlar, belgeler, web sayfaları ve sosyal gönderiler oluşturmanızı sağlar. Bu, Zapier, Make veya n8n gibi araçlarla iş akışlarını otomatikleştirmek, kendi uygulamalarınıza güzel sunum oluşturmayı entegre etmek veya arka uç kod entegrasyonu ile ölçekli sunumlar oluşturmak isteyen kullanıcılar için mükemmeldir.
Ve eğer bir geliştiriciyseniz, Gamma'yı uygulamanıza entegre ederek ona tasarım süper güçleri kazandırabilirsiniz!
💎 Pro İpucu: Pro hesabı veya daha üstü olan herkes bugün cömert kullanım limitleriyle API'ye erişebilir.
API Hazır mı?
Gamma API v1.0, 5 Kasım 2025'ten beri Genel Kullanıma (GA) açıktır. Pro hesabı veya daha üstü olan herkes bugün cömert kullanım limitleriyle API'ye erişebilir.
Belirli API parametreleri ve bunların sunum oluşturmayı nasıl etkilediği hakkında ayrıntılı bilgi için API dokümantasyonumuza bakın.
Nasıl Erişim Sağlarım?
Gamma API'ye erişmek için şu adımları izleyin.
Adım 1: Hesabınızı Yükseltin
Bir Gamma Pro, Ultra, Team veya Business hesabınız olmalıdır. Şu anda Pro kullanıcı veya daha üstü değilseniz, API'ye erişmek için Pro'ya yükseltin.
Adım 2: Bir API Anahtarı Oluşturun
Pro hesabınızda Ayarlar ve Üyeler bölümüne gidin, ardından API key sekmesine geçin. Anahtarınızı oluşturmak için Create API key seçeneğine tıklayın, ardından API anahtarınızı kopyalayıp güvenli bir şekilde saklayın.
🔷 Not: API anahtarları sk-gamma-xxxxxxxx formatını kullanır ve X-API-KEY başlığı ile gönderilmelidir (Bearer token formatı değil).
💎 Pro İpucu: API'yi favori otomasyon araçlarınızla kullanmaya başlayın veya doğrudan arka uç kodunuza entegre edin. Temel URL https://public-api.gamma.app/v1.0/
API anahtarı yerine OAuth ile kimlik doğrulaması yapabilir miyim?
Gamma REST API'ye statik bir API anahtarı yerine OAuth 2.0 ile kimlik doğrulaması yapabilirsiniz. OAuth, uzun ömürlü bir API anahtarı oluşturmadan veya saklamadan Gamma API'yi bir uygulamaya bağlamanızı sağlar; bu, entegrasyonlar ve ortak uygulamalar için faydalıdır. Statik API anahtarları hala tamamen desteklenmektedir, bu yüzden tercih ederseniz X-API-KEY başlığını kullanmaya devam edebilirsiniz. OAuth'u kurmak için geliştirici dokümantasyonundaki Authenticate with OAuth rehberini takip edin: developers.gamma.app/get-started/authenticate-with-oauth.
Kullanım ve Oran Limitleri
Mevcut API Limitleri
Gamma'nın API'si ihtiyaçlarınıza göre ölçeklenmiştir. Birkaç sunum veya yüzlerce sunum oluşturuyor olun, normal kullanımda limitlerle karşılaşmadan ihtiyacınıza göre oluşturabilmelisiniz.
🌀 Bilgi: Oran sınırlaması (HTTP 429 hataları) ile karşılaşırsanız, destek ekibimizle iletişime geçin. API'nin oluşturduklarınızı desteklemesini sağlamak için sizinle çalışacağız!
API'nin yapabilecekleri
Gamma API, bir gammanın oluşturulmasından dışa aktarılmasına kadar tüm yaşam döngüsünü kapsar.
İçerik oluşturma: Kendi metninizden sunumlar, belgeler, web sayfaları ve sosyal gönderiler oluşturun.
Şablondan oluşturma: Gamma'da oluşturduğunuz bir şablondan, düzenini ve kart yapısını koruyarak yeni gammalar oluşturun.
Mevcut gammaları düzenleme: POST /v1.0/agent/gammas/{gammaId}/edits bir sayfaya doğal dil değişikliği uygular.
Agent oluşturma: POST /v1.0/agent/generations bir çalışma alanı şablonundan, mevcut bir gammadan veya resmi Gamma şablonundan oluşturma başlatır.
Mevcut gammaları okuma, dışa aktarma ve analiz etme: Get, yorumlar, dışa aktarma ve analiz uç noktaları.
Bağımsız resim oluşturma: Tam bir gammadan ayrı olarak bireysel resimler oluşturun.
Web sayfası formatı: Sunumlar, belgeler ve sosyal gönderilere ek olarak web sayfaları oluşturun.
Başlıklar ve altbilgi özelleştirme: İçeriğinizin başlıklarını ve altbilgilerini özelleştirin.
Girdi içinde resim URL'leri: İçeriğinizde doğrudan resimlere referans verin.
Klasör organizasyonu: Oluşturulan içeriği klasörlere organize edin.
E-posta ile paylaşım: İçeriği programlı olarak e-posta ile paylaşın.
Liste API'leri: Temalarınızı ve klasörlerinizi listeleyen uç noktalar.
Gamma araması: Erişebildiğiniz gammaların başlıklarında ve tam metinlerinde arama yapın, sonuçları açmadan önce filtreleyin.
Cömert girdi limitleri: 100.000 token'a kadar (yaklaşık 400.000 karakter).
API ile bağımsız resimler oluşturabilir miyim?
Gamma API ve Model Context Protocol (MCP) aracılığıyla bağımsız resimler oluşturabilirsiniz. Bu, tam bir sunum, belge veya web sayfası oluşturmadan ayrı olarak bireysel resimleri programlı olarak oluşturmanızı sağlar. API veya MCP aracılığıyla resim oluşturmak için geliştirici dokümantasyonundaki Create image generation rehberini takip edin. MCP aracılığıyla resim oluşturma Claude, ChatGPT ve diğer MCP istemcilerinde mevcuttur.
API veya MCP ile gammalarımı arayabilir miyim?
Gamma API veya Model Context Protocol (MCP) ile Gamma'ya bağlı bir yapay zeka asistanı aracılığıyla tüm gammalarınızı arayabilirsiniz. Arama, erişiminiz olan her gammanın başlıklarında ve tam metinlerinde yapılır ve sonuçlar alaka düzeyine göre sıralanır, böylece en yakın eşleşme ilk görünür. Her sonuç doğrudan bağlantı içerir, böylece yanıt üzerinden gammayı açabilirsiniz.
Aramanızı gammayı oluşturan kişiye ve son güncelleme tarihine göre daraltabilirsiniz. Arşivlenmiş gammalar varsayılan olarak hariç tutulur, ancak dahil etmeyi seçebilirsiniz.
Arama parametrelerinin tam listesi ve örnek istekler için geliştirici dokümantasyonundaki Search gammas rehberini takip edin: developers.gamma.app/management/search-gammas.
API'yi Ne İçin Kullanabilirim?
Gamma API'yi Make, Zapier, Workato ve diğer iş akışı araçları gibi otomasyon platformlarında kullanabilirsiniz. Ayrıca, kendi uygulamalarınızı güçlendirmek için arka uç koduna doğrudan entegrasyonla özel uygulamalar oluşturabilir, programlı olarak çoklu sunumlar oluşturarak toplu sunumlar yapabilir veya ölçekli kişiselleştirilmiş içerik oluşturabilirsiniz.
🔷 Not: inputText slaytlarınızdaki gerçek içeriği içermelidir, sunumun nasıl oluşturulacağına dair talimatları değil. Temalar önceden Gamma'da oluşturulmalı ve ID ile referans verilmelidir. Temalar inputText ile oluşturulamaz.
Şablon Desteği
Çünkü "templates" farklı kullanıcılar için farklı anlamlara gelir, işte mevcut olanlar.
Görsel temalar: Sunumlarınızın görünümünü ve hissini Gamma'da özel temalar oluşturarak tanımlayabilir, ardından API'de tema kimliklerini kullanarak referans verebilirsiniz. Kullanılabilir tema kimliklerini almak için List Themes API'sini (GET /v1.0/themes) kullanın.
İçerik yapı şablonları: Create from template kullanın. Gamma'da bir şablon oluşturun, ardından kimliği ve bir istemle POST /v1.0/generations/from-template çağrısı yapın. Şablonun düzeni ve kart yapısı varsayılan olarak korunur, isteminiz içeriği, hedef kitleyi veya dili değiştirir. Şablonlar çalışma alanınızdaki tek sayfalık gammlar olmalıdır (bir sayfa birçok kart içerebilir). Şablon kimliklerini bulmak için GET /v1.0/templates/search kullanın.
Agent oluşturma: POST /v1.0/agent/generations ayrıca bir çalışma alanı şablonundan, mevcut bir gammadan veya resmi Gamma şablonundan (templateId) başlayabilir.
Yardım ve Destek Alma
Dokümantasyon ve kaynaklar
Tam teknik referans için geliştirici dokümantasyonunu developers.gamma.app adresinde ziyaret edin. API erişimi Pro, Ultra, Teams ve Business aboneliklerine dahildir.
Hata Ayıklama Yardımı
API sorunlarında yardım gerektiğinde, yaygın sorunlar ve çözümler için hata dokümantasyonumuzu kontrol edin, ardından Müşteri Desteği ile iletişime geçin. Yardım isterken API yanıtınızdaki x-request-id her zaman dahil edin.
Her API yanıtı başlıklarda bu benzersiz tanımlayıcıyı içerir. **Make.com kullanıcıları için, bunu Output → Bundle → Headers altında bulun. Zapier için, başarılı çalıştırmalar için Görev Geçmişinde Run Details → Data Out bölümünü veya başarısız istekler için Logs sekmesinde → Response information (başlıkları genişlet) kontrol edin.
💎 Profesyonel İpucu: Destek talebinde bulunurken her zaman istek kimliğinizi, tam hata mesajını ve istek gövdesi örneğinizi ekleyin.
Destek Kapsamı
Yardım Edebileceğimiz Konular
Gamma'ya özgü API sorunları, kimlik doğrulama ve API anahtarı problemleri, hata mesajlarını anlama, hız sınırı soruları ve kredi kullanımı konularında yardımcı olabiliriz.
Yardım Edemeyeceğimiz Konular
Özel kod yazma veya hata ayıklama, Zapier, Make veya N8N'de tam iş akışları oluşturma, özel uygulamaları hata ayıklama, Zapier, Make veya N8N kullanımı hakkında yönlendirme sağlama veya özel mimari tasarlama konularında yardımcı olamayız.
API yardımı talep ederken, lütfen istek kimliğinizi, hata mesajınızı, istek gövdesi örneğinizi ve kullandığınız otomasyon platformunu belirtin.
Yaygın Hata Kodları
401 Yetkisiz: Geçersiz API anahtarı. X-API-KEY başlığını kullandığınızdan emin olun ( Authorization veya Bearer değil).
403 Yasaklandı: Kredi bakiyenizi kontrol edin ve otomatik dolumun etkin olduğundan emin olun.
429 Çok Fazla İstek: Hız sınırına ulaştınız. Daha yüksek kapasite seçenekleri için Slack desteği ile iletişime geçin.
422 Başarısız: Oluşturma tamamlanamadı. Girdi parametrelerinizi kontrol edin.
Başlarken Yardıma mı İhtiyacınız Var?
Temel sorun giderme ve yaygın API sorunları için kapsamlı sorun giderme rehberimize göz atın. Ayrıca ayrıntılı API referansı ve örnekler için tam geliştirici dokümantasyonumuzu inceleyebilirsiniz.
SSS ve Yaygın Sorunlar
Var olan bir gammayı API ile düzenleyebilir miyim?
Evet.
POST /v1.0/agent/gammas/{gammaId}/edits, örneğin "fiyatlandırma kartını yeni katmanlarla güncelle" gibi doğal dil talimatını düzenleyebileceğiniz bir gamma sayfasına uygular.Sonucu almak için
GET /v1.0/agent/edits/{editId}sorgulayın.Düzenlemeler sayfa ekleyemez ve bir sayfada aynı anda yalnızca bir düzenleme çalışabilir.
Aynı özellik Claude, ChatGPT, Slack ve diğer MCP istemcilerinde de mevcuttur.
Kendi AI ajanım Gamma'yı kullanabilir mi?
Evet. Herhangi bir MCP istemcisini
https://mcp.gamma.app/mcpadresine bağlayın ve Gamma hesabınızla giriş yapın. Her planda çalışır.Özel istemcilerin önce OAuth yönlendirme URI'larının kayıtlı olması gerekir.
API anahtarlarımı başkalarıyla paylaşabilir miyim?
API anahtarları güvenli tutulmalı ve paylaşılmamalıdır.
Gerekirse farklı kullanım durumları için ayrı anahtarlar oluşturun.
Neden API anahtarımı tekrar kopyalayamıyorum?
Güvenlik nedeniyle, API anahtarları oluşturulduğunda yalnızca bir kez gösterilir.
Anahtarınızı kaybederseniz, yeni bir tane oluşturmanız gerekir.
Birden fazla API anahtarı oluşturabilir miyim?
Evet, hesap ayarlarınızdan farklı projeler veya kullanım durumları için birden fazla API anahtarı oluşturabilirsiniz.
API veya MCP arama sonuçlarında hangi gammlar görünür?
Arama yalnızca zaten erişiminiz olan gammaları döndürür, böylece Gamma'da açamayacağınız içerik asla gösterilmez.
Sonuçlar, sorgunuza en yakın eşleşme ilk olacak şekilde alaka düzeyine göre sıralanır.
Arşivlenmiş gammalar, dahil etmeyi seçmediğiniz sürece dışlanır.
Ayrıca oluşturucuya ve bir gammanın en son ne zaman güncellendiğine göre filtreleyebilirsiniz.
Çalışma alanımda neden arama çalışmıyor?
Gammlarınız arasında arama kademeli olarak sunuluyor ve henüz her çalışma alanı için etkin değil.
Eğer mevcut değilse, lütfen Müşteri Desteği ile iletişime geçin ve çalışma alanınızı kontrol edebilmemiz için
x-request-idkodunuzu ekleyin.Düzenleyici: Arama %100 onaylanırsa bu SSS'yi silin.
Kredilerim biterse ne olur?
Kesintisiz API erişimi için faturalandırma ayarlarınızda otomatik yeniden yüklemeyi etkinleştirin: gamma.app/settings/billing.
API tarafından oluşturulan sunumlar Gamma kontrol panelinde nerede görünür?
API ile oluşturulan sunumlar Gamma kontrol panelinde API Generated bölümünde görünür, ana Gammlar listenizde (Tümü, Son Görüntülenen veya Siz Oluşturduğunuz) değil.
API tarafından oluşturulan bir sunumun normal Gammlar listenizde görünmesini sağlamak için, açın ve Düzenle yerine Duplicate seçeneğini seçin. Kopya, standart web oluşturulan gamma olarak kabul edilir ve tüm normal görünümlerde görünür.