Gamma API nedir?
Sevdiğiniz bir sunumunuz mu var? Peki ya dünya çapında 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 itibarıyla Genel Kullanıma (GA) sunulmuştur. Pro hesabı veya daha üstü olan herkes bugün cömert kullanım limitleriyle API'ye erişebilir.
🔷 Not: API v0.2 kullanımdan kaldırılmıştır ve 16 Ocak 2026 tarihinde sona erecektir. Şu anda v0.2 kullanıyorsanız, lütfen bu tarihten önce v1.0'a geçiş yapın.
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ı 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 butonuna tıklayın, ardından API anahtarınızı kopyalayıp güvenli bir şekilde saklayın.
🔷 Not: API anahtarları sk-gamma-xxxxxxxx formatındadır ve X-API-KEY başlığı kullanılarak iletilmelidir (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:
Web sayfası formatı: Sunumların, belgelerin ve sosyal gönderilerin yanı sıra web sayfaları oluşturun.
Başlıklar ve altbilgiler özelleştirmesi: İçeriğinizin başlıklarını ve altbilgilerini özelleştirin.
Girdi içindeki 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şturmaktan 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 mevcuttur; henüz ChatGPT'de 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üphanenizi arayabilirsiniz. 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 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 sunulmaktadır, bu yüzden henüz her çalışma alanında mevcut değildir. Arama uç noktası veya MCP arama aracı sizin için çalışmıyorsa, çalışma alanınız henüz bu özelliği almamıştır.
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ı 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 birden fazla sunum oluşturarak toplu sunumlar 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 Gamma'da önceden oluşturulmalı ve ID ile referans verilmelidir. Temalar inputText ile oluşturulamaz.
Şablon Desteği
"templates" farklı kullanıcılar için farklı anlamlara geldiğinden, mevcut olanlar şunlardır.
Görsel temalar: Gamma'da özel temalar oluşturarak sunumlarınızın görünümünü ve hissini tanımlayabilir, ardından API'de tema ID'si kullanarak 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 Reference dokümantasyonunu ziyaret edin. Ayrıca genel bakış ve başlangıç kılavuzu için Landing Page'imizi 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ü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 değerini mutlaka ekleyin.
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ın Task History'deki Run Details → Data Out bölümünü veya başarısız istekler için Logs sekmesindeki Response information (başlıkları genişletin) kısmını kontrol edin.
💎 Profesyonel İ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ı, hız limiti 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 yapma veya özel mimari tasarlama konularında yardımcı olamayız.
API yardımı talep ederken 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 Unauthorized: Geçersiz API anahtarı. X-API-KEY başlığını kullandığınızdan emin olun ( Authorization veya Bearer değil).
403 Forbidden: Kredi bakiyenizi kontrol edin ve otomatik dolumun etkin olduğundan emin olun.
429 Too Many Requests: Hız limitine ulaştınız. Daha yüksek kapasite seçenekleri için Slack desteği ile iletişime geçin.
422 Failed: 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 kılavuzumuza 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
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ı yalnızca Oluşturulduğunda 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ız üzerinden farklı projeler veya kullanım durumları için birden fazla API anahtarı Oluşturabilirsiniz.
API veya MCP arama sonuçlarında hangi gammalar görünür?
Arama yalnızca zaten erişiminiz olan gammaları döndürür, böylece açamadığınız içerikler asla görünmez.
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 arama neden çalışmıyor?
Gammlarınızda arama kademeli olarak sunuluyor ve henüz her çalışma alanı için etkin değil.
Eğer mevcut değilse, Müşteri Desteği ile iletişime geçin ve çalışma alanınızı kontrol edebilmemiz için
x-request-iddeğerini ekleyin.
v0.2'den v1.0'a geçiş yapmam gerekiyor mu?
Evet, v0.2 16 Ocak 2026 tarihinde sona erecek.
Geçiş basittir: Temel URL'nizi
/v0.2/den/v1.0/a güncelleyin.themeNameparametresinithemeIdolarak değiştirin (ID'leri List Themes API'den alın).Girdi limitlerini güncelleyin - v1.0, 750k karakter yerine 100k token kullanır.
Tam v1.0 uç nokta detayları için API dokümantasyonunu kontrol edin.
v0.2 ile v1.0 arasındaki temel farklar nelerdir?
v1.0 çok daha cömert hız limitleri sunar (günde 50 yerine saatte yüzlerce).
v1.0 web sayfası format desteği içerir.
Daha iyi girdi limitleri (750k karakter yerine 100k token).
Klasör organizasyonu ve Temalar ve klasörler için Liste API'leri.
Kredilerim biterse ne olur?
Kesintisiz API erişimi için gamma.app/settings/billing adresindeki faturalandırma ayarlarınızda otomatik yeniden yüklemeyi etkinleştirin.
API tarafından oluşturulan sunumlar Gamma kontrol panelinde nerede görünür?
API aracılığıyla oluşturulan sunumlar Gamma kontrol panelindeki API Generated bölümünde görünür, ana Gammas listenizde (Tümü, Son Görüntülenen veya Siz Oluşturduğunuz) değil.
API tarafından oluşturulan bir sunumun normal Gammas listenizde görünmesini sağlamak için, açın ve Duplicate seçeneğini seçin. Kopya, standart web oluşturulan gamma olarak kabul edilir ve tüm olağan görünümlerde gösterilir.