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: Bugün herkes herhangi bir planda, Ücretsiz dahil, 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. Bugün herkes herhangi bir planda cömert kullanım limitleriyle API'ye erişebilir.
Belirli API parametreleri ve bunların sunum oluşturmayı nasıl etkilediği hakkında detaylı 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: Bir API Anahtarı Oluşturun
Hesabınızda Ayarlar ve Üyeler bölümüne gidin, ardından API key sekmesine geçin. Create API key butonuna tıklayarak anahtarınızı oluşturun, sonra 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şlayabilir veya doğrudan arka uç kodunuza entegre edebilirsiniz. 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 kurulumunu yapmak 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 oluşturuyor olun ya da yüzlerce, normal kullanımda limitlere takılmadan ihtiyacınıza göre oluşturabilmelisiniz.
🌀 Bilgi: Eğer oran sınırlaması (HTTP 429 hataları) ile karşılaşırsanız, destek ekibimizle iletişime geçin. API'nin ihtiyaçlarınızı karşılamasını sağlamak için sizinle çalışacağız!
API'nin yapabilecekleri
Gamma API, bir gamma'nın oluşturulmasından dışa aktarılmasına kadar tüm yaşam döngüsünü kapsar.
İçerik oluşturun: Kendi metninizden sunumlar, belgeler, web sayfaları ve sosyal gönderiler oluşturun.
Şablondan oluşturun: Gamma'da oluşturduğunuz bir şablondan yeni gamalar oluşturun, düzenini ve kart yapısını koruyarak.
Mevcut gamaları düzenleyin: POST /v1.0/agent/gammas/{gammaId}/edits doğal dil kullanarak bir sayfada değişiklik yapar.
Agent oluşturma: POST /v1.0/agent/generations bir çalışma alanı şablonundan, mevcut bir gamadan veya resmi Gamma şablonundan oluşturma başlatır.
Mevcut gamaları okuyun, dışa aktarın ve analiz edin: Get, yorumlar, dışa aktarım ve analiz uç noktaları.
Bağımsız resim oluşturma: Tam bir gamma'dan 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 altbilgiler özelleştirme: İçeriğinizin başlıklarını ve altbilgilerini özelleştirin.
Girdi içinde resim URL'leri: İçeriğinizde resimlere doğrudan 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 gamaları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 üzerinden resim oluşturma Claude, ChatGPT ve diğer MCP istemcilerinde mevcuttur.
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ı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 gamma'yı doğrudan 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.
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 çok sayıda sunum oluşturabilir 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 aracılığıyla 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 bunlara referans verebilirsiniz. Mevcut 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 ID'si ve bir istem ile 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 GET /v1.0/templates/search ile bulun.
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 ziyaret edin. API erişimi, Ücretsiz dahil tüm planlarda mevcuttur.
Hata ayıklama yardımı
API sorunlarında yardıma ihtiyacınız olduğunda, 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) 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ın anlaşılması, 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 (kod Authorization veya Bearer değil).
403 Yasaklandı: Kredi bakiyenizi kontrol edin ve otomatik yenilemenin 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
API ile mevcut bir gammayı 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ışır.
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'lerinin 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 ortaya çıkmaz.
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?
Gammasınızda arama özelliği kademeli olarak sunuluyor ve henüz her çalışma alanı için etkin değil.
Eğer mevcut değilse, çalışma alanınızı kontrol edebilmemiz için
x-request-idkodunuzu ekleyerek Müşteri Desteği ile iletişime geçin.Yayıncı: Arama %100 onaylandığında 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 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ünmesi 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.