Ana içeriğe geç

Gamma API Sorun Giderme

Destek kapsamı, yaygın hata kodları ve alınacak sorun giderme adımları.

Gamma API Sorun Giderme Kılavuzu

API ile ilgili her konuda yardımcı olmak isteriz ancak destek ekibimizin iş akışları oluşturamayacağını, backend kodunuzu (FastAPI, Express, Django vb.) hata ayıklayamayacağını veya platforma özgü sorunları gideremeyeceğini unutmayın.

Gamma'ya özgü uç noktalarımız ve parametreler, API kimlik doğrulaması, hata giderme, krediler ve isteğinizin belgelerimizle uyumlu olup olmadığını doğrulama konularında yardımcı olabiliriz.

Platforma özgü yardım için Zapier Support, Make Support veya N8N Support ile iletişime geçin.

Gamma'nın API'si hakkında daha fazla bilgi için bkz: developers.gamma.app


Yaygın hata kodları

400 Bad Request

Geçersiz parametreler

İsteğinizi kontrol edin:

  • Gerekli alanlar eksik (inputText, textMode).

  • Geçersiz parametre değerleri.

  • Karakter veya token sınırları aşıldı.

  • from-template için: şablon tek sayfalık workspace gamma olmalıdır. Resmi Explore şablonları ve çok sayfalı gammalar reddedilir.

Belirli doğrulama ayrıntıları için hata mesajını inceleyin.


401 Unauthorized

Geçersiz API anahtarı

API anahtarınız geçersiz veya Pro hesabıyla ilişkilendirilmemiş.

  1. X-API-KEY başlığını kullandığınızdan emin olun (Authorization değil).

  2. Yeni bir API anahtarı oluşturun: gamma.app/settings/api-keys.

  3. Hesabınızın aktif bir Pro, Ultra, Teams veya Business planına sahip olduğunu doğrulayın.


403 Forbidden

Kredi yok

Hesabınızın API kredisi kalmadı.

Bunu şu adreste düzeltin: gamma.app/settings/billing:

  • Otomatik yeniden yüklemeyi etkinleştirin (önerilir).

  • Kredileri gerektiğinde satın alın.

  • Daha yüksek bir plan seviyesine yükseltin.


404 Not Found

Geçersiz generation veya gamma ID

Generation ID mevcut değil veya başka bir kullanıcıya ait. Bu hata, okuma, düzenleme veya mevcut bir gamma'yı dışa aktarma sırasında erişemediğiniz bir gamma ID için de döner.

POST yanıtından doğru generationId kullandığınızdan veya hedeflediğiniz gamma'ya erişiminiz olduğundan emin olun.


422 Failed

Generation tamamlanamadı

Generation boş çıktı üretti.

İsteğinizi gözden geçirin:

  • inputText yeterli içeriğe sahip olmalı.

  • Parametrelerin girdinizle uyumlu olduğundan emin olun.

  • Gerekirse karmaşık talimatları basitleştirin.


429 Too Many Requests

İstek sınırı aşıldı

İstek sınırına ulaştınız. Sınırlar API anahtarı sahibi ve workspace başına belirlenir ve mevcut değerler hata kodları referansında belgelenmiştir.

🔷 Not: API geniş kapasiteye sahiptir. Çoğu kullanıcı normal kullanımda bu sınırla karşılaşmaz.

Çözümler:

  1. Daha yüksek kapasite için Gamma Support ile iletişime geçin.

  2. Üssel geri çekilme uygulayın.

  3. İstekleri zamana yayın.


500 Internal Server Error

Beklenmeyen sunucu hatası

Geçici bir sunucu sorunu oluştu.

  1. Bir süre bekleyip tekrar deneyin.

  2. Süreklilik varsa, x-request-id ile destek ekibiyle iletişime geçin.


502 Bad Gateway

Geçici ağ geçidi sorunu

Geçici bir bağlantı sorunu oluştu.

Bir süre bekleyip isteğinizi tekrar gönderin.


API tarafından oluşturulan sunumlar Gammas listemde görünmüyor

API tarafından 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 Sizin Tarafınızdan Oluşturulan) değil. Bu beklenen bir davranıştır ve sunumun adını değiştirmek kategorisini değiştirmez.

Çözüm: Sunumu açın ve Duplicate seçeneğini seçin. Kopya, normal web oluşturulan gamma olarak kabul edilir ve ana Gammas listenizde görünür.

Hala yardıma mı ihtiyacınız var?

Bu cevap sorunuzu yanıtladı mı?