Gamma API nedir?
Sevdiğiniz bir sunumunuz mu var? Ya dünyadaki farklı izleyiciler için kişiselleştirilmiş 100 tane daha oluşturabilseydiniz?
Gamma Generate 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, güzel sunum oluşturmayı kendi uygulamalarınıza 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.
Erişim Nasıl Alınır?
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ı değilseniz veya daha üstü, 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 API key Oluştur'a 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 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 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çeklenmek üzere tasarlanmıştır. Birkaç sunum veya yüzlerce sunum oluşturuyor olun, normal kullanımda limitlere takılmadan 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!
v1.0'da Neler Yeni?
API v1.0 birkaç güçlü yeni özellik içerir:
Webpage formatı: Sunumların yanı sıra web sayfaları da oluşturun.
Başlıklar ve altbilgiler özelleştirmesi: İç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 paylaşımı: İçeriği programlı olarak e-posta ile paylaşın.
Liste API'leri: Temalarınızı ve klasörlerinizi listelemek için yeni uç noktalar.
Gamma araması: Erişebildiğiniz gamaların başlıklarını ve tam metinlerini arayın, sonuçları açmadan önce filtreleyin.
Daha iyi girdi limitleri: 100.000 token'a kadar (yaklaşık 400.000 karakter).
🌀 Bilgi: API geliştikçe, Gamaları programlı olarak değiştirmek ve yeniden karıştırmak için daha fazla seçenek eklemeye devam edeceğiz.
API ile bağımsız resimler oluşturabilir miyim?
Artık Gamma Generate 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 programlı şekilde bireysel resimler 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: developers.gamma.app/images/create-image-generation. MCP aracılığıyla resim oluşturma Claude ve diğer MCP istemcilerinde bugün mevcut; ChatGPT'de henüz yoktur.
API veya MCP ile gamalarımı arayabilir miyim?
Gamma API veya Model Context Protocol (MCP) ile Gamma'ya bağlı bir yapay zeka asistanı aracılığıyla tüm gamma kütüphanenizde arama yapabilirsiniz. Arama, erişiminiz olan her gamanın başlıkları ve tam metinleri üzerinde yapılır ve sonuçlar alaka düzeyine göre sıralanır, en yakın eşleşme ilk olarak görünür. Her sonuç doğrudan bağlantı içerir, böylece yanıt üzerinden gamma'yı açabilirsiniz.
Aramanızı gamma'yı oluşturan kişiye ve son güncelleme tarihine göre daraltabilirsiniz. Arşivlenmiş gamalar varsayılan olarak hariç tutulur, ancak dahil etmeyi seçebilirsiniz.
🔷 Not: Arama kademeli olarak sunuluyor, bu yüzden henüz her çalışma alanında mevcut değil. Arama uç noktası veya MCP arama aracı sizin için çalışmıyorsa, çalışma alanınız henüz almadı demektir.
Arama parametrelerinin tam listesi ve örnek istekler için geliştirici dokümantasyonundaki Search gammas rehberine bakın: 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ı için kullanabilirsiniz. Ayrıca kendi uygulamalarınızı güçlendirmek için arka uç koduna doğrudan entegrasyonla özel uygulamalar oluşturabilir, programlı olarak çok sayıda sunum oluşturabilir veya ölçekli kişiselleştirilmiş içerik yaratabilirsiniz.
🔷 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
"Şablonlar" farklı kullanıcılar için farklı anlamlar taşıdığından, işte mevcut olanlar.
Görsel temalar: Gamma'da özel temalar oluşturarak sunumlarınızın görünümünü tanımlayabilir, ardından API'de tema ID'si ile referans verebilirsiniz. Mevcut tema ID'lerini almak için List Themes API'sini (GET /v1.0/themes) kullanın.
İçerik yapı şablonları: Gelecek güncellemelerde katı içerik yapı desteği eklemeye çalışıyoruz.
Yardım ve Destek Alma
Dokümantasyon ve Kaynaklar
Tam teknik referans için API Referans dokümantasyonunu ziyaret edin. Ayrıca genel bakış ve başlangıç rehberi için Açılış Sayfamızı inceleyebilirsiniz. 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ümantasyonumuza bakın, ardından Müşteri Desteği ile iletişime geçin. Yardım isterken API yanıtınızdaki x-request-idyi mutlaka ekleyin.
Her API yanıtı bu benzersiz tanımlayıcıyı başlıklarda içerir. Make.com kullanıcıları için bunu Output → Bundle → Headers altında bulun. Zapier için başarılı çalıştırmalarda Run Details → Data Out bölümüne, başarısız isteklerde ise Logs sekmesi → Response information (başlıkları genişletin) kısmına bakın.
💎 Pro İpucu: Destek talebinde bulunurken her zaman istek ID'nizi, 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ın anlaşılması, oran limiti soruları ve kredi kullanımı konularında yardımcı olabiliriz.
Yardım Edemediğ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ı isterken lütfen istek ID'nizi, 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: Oran limitine 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 bakın. Ayrıca ayrıntılı API referansı ve örnekler için tam geliştirici dokümantasyonumuzu inceleyebilirsiniz.
SSS ve Yaygın Sorunlar
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.
API anahtarımı neden 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 gamalar görünür?
Arama yalnızca zaten erişiminiz olan gamaları döndürür, böylece Gamma'da açamayacağınız içerik asla ifşa edilmez.
Sonuçlar alaka düzeyine göre sıralanır, sorgunuza en yakın eşleşme ilk olarak görünür.
Arşivlenmiş gamalar varsayılan olarak hariç tutulur, ancak dahil etmeyi seçebilirsiniz.
Ayrıca oluşturucuya ve son güncellenme tarihine göre filtreleyebilirsiniz.
Çalışma alanımda neden arama çalışmıyor?
Gamma'larınızda arama kademeli olarak sunuluyor ve henüz her çalışma alanında etkin değil.
Mevcut değilse, Müşteri Desteği ile iletişime geçin ve çalışma alanınızı kontrol etmemiz için
x-request-idyi ekleyin.
Kredilerim biterse ne olur?
Kesintisiz API erişimi için gamma.app/settings/billing adresindeki faturalandırma ayarlarınızda otomatik dolumu etkinleştirin.
API ile 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 Gamma listenizde (Tümü, Son Görüntülenenler veya Sizin Tarafınızdan Oluşturulanlar) değil.
API ile oluşturulan bir sunumun normal Gamma listenizde görünmesi için açın ve Duplicate seçeneğini seçin. Kopya, standart web oluşturulan gamma olarak işlenir ve tüm normal görünümlerde görünür.