Panduan Pemecahan Masalah API Gamma

Meskipun kami ingin membantu dengan semua hal terkait API, harap diingat tim dukungan kami tidak dapat membuat alur kerja, debug kode backend Anda (FastAPI, Express, Django, dll.), atau memecahkan masalah khusus platform.

Kami dapat membantu dengan pertanyaan khusus Gamma tentang endpoints dan parameter kami, autentikasi API, pemecahan masalah kesalahan, kredit, dan memverifikasi permintaan Anda sesuai dengan dokumentasi kami.

Untuk bantuan khusus platform, hubungi Zapier Support, Make Support, atau N8N Support.

Untuk informasi lebih lanjut tentang API Gamma, lihat: developers.gamma.app

Kode kesalahan umum

400 Permintaan Buruk

Parameter tidak valid

Periksa permintaan Anda untuk:

Field wajib yang hilang (inputText, textMode).
Nilai parameter tidak valid.
Batas karakter atau token terlampaui.
Untuk from-template: templat harus berupa workspace gamma satu halaman. Templat Explore resmi dan gamma multi-halaman ditolak.

Tinjau pesan kesalahan untuk detail validasi spesifik.

401 Tidak Sah

Kunci API tidak valid

Kunci API Anda tidak valid atau tidak terkait dengan akun Pro.

Verifikasi Anda menggunakan header X-API-KEY (bukan Authorization).
Buat kunci API baru di gamma.app/settings/api-keys.
Konfirmasi akun Anda memiliki paket Pro, Ultra, Teams, atau Business yang aktif.

403 Terlarang

Tidak ada kredit tersedia

Akun Anda telah kehabisan kredit API.

Perbaiki ini di gamma.app/settings/billing:

Aktifkan pengisian ulang otomatis (disarankan).
Beli kredit secara ad hoc.
Tingkatkan ke paket yang lebih tinggi.

404 Tidak Ditemukan

ID generasi atau gamma tidak valid

ID generasi tidak ada atau milik pengguna lain. Kesalahan ini juga dikembalikan untuk ID gamma yang tidak dapat Anda akses saat membaca, mengedit, atau mengekspor gamma yang ada.

Periksa bahwa Anda menggunakan generationId yang benar dari respons POST, atau bahwa Anda memiliki akses ke gamma yang Anda tuju.

422 Gagal

Generasi tidak dapat diselesaikan

Generasi menghasilkan output kosong.

Tinjau permintaan Anda:

Pastikan inputText memiliki konten yang cukup.
Periksa bahwa parameter sesuai dengan input Anda.
Sederhanakan instruksi kompleks jika perlu.

429 Terlalu Banyak Permintaan

Batas kecepatan terlampaui

Anda telah mencapai batas kecepatan. Batas ditetapkan per pemilik kunci API dan per workspace, dan nilai saat ini didokumentasikan dalam referensi kode kesalahan.

➡️ developers.gamma.app/reference/error-codes

🔷 Catatan: API memiliki kapasitas yang besar. Sebagian besar pengguna tidak pernah menemui batas ini dalam penggunaan normal.

Solusi:

Hubungi Gamma Support untuk kapasitas lebih tinggi.
Terapkan exponential backoff.
Sebar permintaan dari waktu ke waktu.

500 Kesalahan Server Internal

Kesalahan server tak terduga

Terjadi masalah server sementara.

Tunggu sebentar dan coba lagi.
Jika terus berlanjut, hubungi dukungan dengan x-request-id Anda.

502 Gateway Buruk

Masalah gateway sementara

Terjadi masalah koneksi sementara.

Tunggu sebentar dan coba permintaan Anda lagi.

Presentasi yang dihasilkan API saya tidak ada di daftar Gammas saya

Presentasi yang dihasilkan API muncul di bagian API Generated pada dashboard Gamma, bukan di daftar Gammas utama Anda (Semua, Baru Dilihat, atau Dibuat oleh Anda). Ini adalah perilaku yang diharapkan, dan mengganti nama presentasi tidak mengubah cara pengkategorian.

Solusi sementara: Buka presentasi dan pilih Duplicate. Duplikat diperlakukan sebagai gamma biasa yang dibuat di web dan akan muncul di daftar Gammas utama Anda.

Masih butuh bantuan?

Dukungan Umum: Cara menghubungi dukungan Gamma.
Komunitas API: Bergabung dengan Gamma API Slack.
Masalah SSO: Hubungi administrator TI organisasi Anda.