Apa itu Gamma API?
Punya deck yang Anda sukai? Bagaimana jika Anda bisa membuat 100 lagi yang sama, dipersonalisasi untuk berbagai audiens di seluruh dunia?
Gamma Buat API memungkinkan Anda membuat presentasi, dokumen, halaman web, dan posting sosial secara programatis tanpa menggunakan aplikasi Gamma secara langsung. Ini sempurna untuk pengguna yang ingin mengotomatisasi alur kerja mereka menggunakan alat seperti Zapier, Make, atau n8n, mengintegrasikan pembuatan presentasi yang indah ke dalam aplikasi mereka sendiri, atau membuat presentasi dalam skala besar melalui integrasi kode backend.
Dan jika Anda seorang pengembang, Anda dapat mengintegrasikan Gamma ke dalam aplikasi Anda untuk memberikannya kekuatan desain super!
💎 Pro Tip: Siapa saja dapat mengakses API hari ini pada paket apa pun, termasuk Gratis, dengan batas penggunaan yang murah hati.
Apakah API Sudah Siap?
Gamma API v1.0 telah Tersedia Umum (GA) sejak 5 November 2025. Siapa saja dapat mengakses API hari ini pada paket apa pun dengan batas penggunaan yang murah hati.
Untuk informasi rinci tentang parameter API tertentu dan bagaimana mereka memengaruhi pembuatan presentasi, lihat dokumentasi API kami.
Bagaimana Cara Mendapatkan Akses?
Untuk mengakses Gamma API, ikuti langkah-langkah ini.
Langkah 1: Buat Kunci API
Navigasikan ke Pengaturan and Anggota di akun Anda, lalu buka tab kunci API. Klik Buat kunci API untuk membuat kunci Anda, lalu salin dan simpan kunci API Anda dengan aman.
🔷 Catatan: Kunci API menggunakan format sk-gamma-xxxxxxxx dan harus dikirim menggunakan header X-API-KEY (bukan format token Bearer).
💎 Pro Tip: Mulailah menggunakan API dengan alat otomasi favorit Anda atau integrasikan langsung ke kode backend Anda. URL dasar adalah https://public-api.gamma.app/v1.0/
Bisakah saya mengautentikasi dengan OAuth alih-alih kunci API?
Anda dapat mengautentikasi dengan Gamma REST API menggunakan OAuth 2.0 alih-alih kunci API statis. OAuth memungkinkan Anda menghubungkan Gamma API ke aplikasi tanpa membuat atau menyimpan kunci API jangka panjang, yang berguna untuk integrasi dan aplikasi mitra. Kunci API statis masih sepenuhnya didukung, jadi Anda dapat terus menggunakan header X-API-KEY jika Anda mau. Untuk mengatur OAuth, ikuti panduan Authenticate with OAuth dalam dokumentasi pengembang di developers.gamma.app/get-started/authenticate-with-oauth.
Penggunaan dan Batasan Rate
Batas API Saat Ini
API Gamma dibangun untuk menyesuaikan dengan kebutuhan Anda. Baik Anda membuat beberapa presentasi atau ratusan, Anda harus dapat membuat sesuai kebutuhan penggunaan Anda tanpa mengalami batasan selama penggunaan normal.
🌀 Insight: Jika Anda mengalami pembatasan rate (kesalahan HTTP 429), hubungi tim dukungan kami. Kami akan bekerja sama dengan Anda untuk memastikan API mendukung apa yang Anda bangun!
Apa yang dapat dilakukan API
Gamma API mencakup siklus hidup penuh dari gamma, dari pembuatan hingga Ekspor.
Buat konten: Buat presentasi, dokumen, halaman web, dan posting sosial dari teks Anda sendiri.
Buat dari templat: Buat gamma baru dari templat yang Anda buat di Gamma, mempertahankan tata letak dan struktur kartu.
Edit gamma yang ada: POST /v1.0/agent/gammas/{gammaId}/edits menerapkan perubahan bahasa alami pada satu halaman.
Buat agen: POST /v1.0/agent/generations memulai pembuatan dari templat workspace, gamma yang ada, atau templat resmi Gamma.
Baca, Ekspor, dan analisis gamma yang ada: Dapatkan, komentar, Ekspor, dan endpoint analitik.
Buat gambar mandiri: Buat gambar individual secara terpisah dari gamma penuh.
Format halaman web: Buat halaman web selain presentasi, dokumen, dan posting sosial.
Kustomisasi header dan footer: Sesuaikan header dan footer konten Anda.
URL gambar dalam input: Referensikan gambar langsung dalam konten Anda.
Organisasi folder: Atur konten yang dibuat ke dalam folder.
Bagikan email: Bagikan konten melalui email secara programatis.
List API: Endpoint untuk daftar Tema dan folder Anda.
Cari gamma: Cari judul dan teks lengkap gamma yang dapat Anda akses, dan saring hasil sebelum membukanya.
Batas input yang murah hati: Hingga 100.000 token (sekitar 400.000 karakter).
Bisakah saya membuat gambar mandiri dengan API?
Anda dapat membuat gambar mandiri dengan Gamma API dan melalui Model Context Protocol (MCP). Ini memungkinkan Anda membuat gambar individual secara programatis, terpisah dari membuat presentasi, dokumen, atau halaman web penuh. Untuk membuat gambar melalui API atau MCP, ikuti panduan Buat pembuatan gambar dalam dokumentasi pengembang. Pembuatan gambar melalui MCP tersedia di Claude, ChatGPT, dan klien MCP lainnya.
Bisakah saya mencari gamma saya dengan API atau MCP?
Anda dapat mencari seluruh perpustakaan gamma Anda dari Gamma API atau melalui asisten AI yang terhubung ke Gamma dengan Model Context Protocol (MCP), standar terbuka yang memungkinkan asisten AI terhubung ke alat seperti Gamma. Pencarian mencakup judul dan teks lengkap setiap gamma yang Anda akses, dan mengurutkan hasil berdasarkan relevansi sehingga hasil terdekat muncul pertama. Setiap hasil menyertakan tautan langsung, sehingga Anda dapat membuka gamma langsung dari respons.
Anda dapat mempersempit pencarian berdasarkan siapa yang membuat gamma dan kapan terakhir diperbarui. Gamma yang diarsipkan secara default dikecualikan, dan Anda dapat memilih untuk menyertakannya.
Untuk daftar lengkap parameter pencarian dan contoh permintaan, ikuti panduan Cari gamma dalam dokumentasi pengembang di developers.gamma.app/management/search-gammas.
Untuk Apa Saya Bisa Menggunakan API?
Manfaatkan Gamma API untuk platform otomasi seperti Make, Zapier, Workato, dan alat alur kerja lainnya. Anda juga dapat membangun aplikasi khusus dengan integrasi langsung ke kode backend untuk mendukung aplikasi Anda sendiri, membuat presentasi massal dengan membuat beberapa presentasi secara programatis, atau membuat konten yang dipersonalisasi dalam skala besar.
🔷 Catatan: inputText Anda harus berisi konten sebenarnya yang Anda inginkan di slide Anda, bukan instruksi tentang cara membuat presentasi. Tema harus sudah dibuat sebelumnya di Gamma dan dirujuk dengan ID. Tema tidak dapat dibuat melalui inputText.
Dukungan Templat
Karena "templat" berarti hal berbeda bagi pengguna yang berbeda, berikut yang tersedia.
Tema visual: Anda dapat menentukan tampilan dan nuansa presentasi Anda dengan membuat tema khusus di Gamma, lalu merujuknya di API menggunakan ID tema mereka. Gunakan List Themes API (GET /v1.0/themes) untuk mendapatkan ID tema yang tersedia.
Templat struktur konten: Gunakan Create from template. Bangun templat di Gamma, lalu panggil POST /v1.0/generations/from-template dengan ID dan prompt-nya. Tata letak dan struktur kartu templat dipertahankan secara default, dan prompt Anda mengubah konten, audiens, atau bahasa. Templat harus berupa gamma satu halaman dari workspace Anda (satu halaman dapat memuat banyak kartu). Temukan ID templat dengan GET /v1.0/templates/search.
Generasi agen: POST /v1.0/agent/generations juga dapat dimulai dari templat workspace, gamma yang sudah ada, atau templat resmi Gamma (templateId).
Mendapatkan Bantuan dan Dukungan
Dokumentasi dan sumber daya
Untuk referensi teknis lengkap, kunjungi dokumentasi pengembang. Akses API termasuk dalam semua paket, termasuk Free.
Bantuan debugging
Saat Anda membutuhkan bantuan dengan masalah API, periksa dokumentasi kesalahan kami untuk masalah umum dan solusi, lalu hubungi Customer Support. Selalu sertakan x-request-id dari respons API Anda saat meminta bantuan.
Setiap respons API menyertakan pengenal unik ini di header. Untuk **Make.com users**, temukan di bawah Output → Bundle → Headers. Untuk Zapier, periksa bagian Run Details → Data Out di Riwayat Tugas untuk run yang berhasil, atau tab Logs → Response information (perluas header) untuk permintaan yang gagal.
💎 Pro Tip: Selalu sertakan request ID Anda, pesan kesalahan yang tepat, dan contoh body permintaan Anda saat meminta dukungan.
Lingkup Dukungan
Kami Bisa Membantu Dengan
Kami dapat membantu dengan masalah API khusus Gamma, masalah autentikasi dan kunci API, memahami pesan kesalahan, pertanyaan batas laju, dan pertanyaan penggunaan kredit.
Kami Tidak Bisa Membantu Dengan
Kami tidak dapat debugging atau menulis kode khusus, membangun workflow lengkap di Zapier, Make, atau N8N, debugging aplikasi khusus, memberikan petunjuk penggunaan Zapier, Make, atau N8N, atau merancang arsitektur khusus.
Saat meminta bantuan API, harap berikan request ID Anda, pesan kesalahan, contoh body permintaan, dan platform otomatisasi yang Anda gunakan.
Kode Kesalahan Umum
401 Unauthorized: Kunci API tidak valid. Pastikan Anda menggunakan header X-API-KEY (bukan Authorization atau Bearer).
403 Forbidden: Periksa saldo kredit Anda dan pastikan auto-recharge diaktifkan.
429 Too Many Requests: Anda telah mencapai batas laju. Hubungi dukungan Slack untuk opsi kapasitas lebih tinggi.
422 Failed: Generasi tidak dapat diselesaikan. Periksa parameter input Anda.
Butuh Bantuan Memulai?
Untuk pemecahan masalah dasar dan masalah API umum, lihat panduan pemecahan masalah kami yang komprehensif. Anda juga dapat meninjau dokumentasi pengembang lengkap kami untuk referensi API dan contoh detail.
FAQ & Masalah Umum
Bisakah saya edit gamma yang sudah ada dengan API?
Ya.
POST /v1.0/agent/gammas/{gammaId}/editsmenerapkan instruksi bahasa alami ke satu halaman gamma yang dapat Anda edit, misalnya "perbarui kartu harga dengan tingkatan baru."Polling
GET /v1.0/agent/edits/{editId}untuk hasilnya.Edit tidak dapat menambah halaman, dan hanya satu edit yang berjalan pada satu halaman pada satu waktu.
Kemampuan yang sama tersedia di Claude, ChatGPT, Slack, dan klien MCP lainnya.
Bisakah agen AI saya sendiri menggunakan Gamma?
Ya. Hubungkan klien MCP apa pun ke
https://mcp.gamma.app/mcpdan masuk dengan akun Gamma Anda. Ini berfungsi di setiap paket.Klien khusus perlu mendaftarkan URI pengalihan OAuth mereka terlebih dahulu.
Bisakah saya membagikan kunci API saya dengan orang lain?
Kunci API harus dijaga keamanannya dan tidak boleh dibagikan.
Buat kunci terpisah untuk berbagai kasus penggunaan jika diperlukan.
Mengapa saya tidak bisa menyalin kunci API saya lagi?
Untuk alasan keamanan, kunci API hanya ditampilkan sekali saat dibuat.
Jika Anda kehilangan kunci, Anda harus membuat yang baru.
Bisakah saya membuat beberapa kunci API?
Ya, Anda dapat membuat beberapa kunci API untuk proyek atau kasus penggunaan berbeda melalui pengaturan akun Anda.
Gamma mana yang muncul dalam hasil pencarian API atau MCP?
Pencarian hanya mengembalikan gamma yang sudah Anda akses, jadi tidak pernah mengekspos konten yang tidak dapat Anda buka di Gamma.
Hasil diurutkan berdasarkan relevansi, dengan kecocokan terdekat dengan kueri Anda di urutan pertama.
Gamma yang diarsipkan tidak termasuk kecuali Anda memilih untuk menyertakannya.
Anda juga dapat memfilter berdasarkan pembuat dan kapan gamma terakhir diperbarui.
Mengapa pencarian tidak berfungsi di workspace saya?
Pencarian di seluruh gammas Anda sedang diluncurkan secara bertahap dan belum diaktifkan untuk setiap workspace.
Jika tidak tersedia, hubungi Customer Support dan sertakan
x-request-idAnda agar kami dapat memeriksa workspace Anda.Editor: delete this FAQ if search is confirmed at 100%.
Apa yang terjadi jika saya kehabisan kredit?
Aktifkan auto-recharge di pengaturan penagihan Anda di gamma.app/settings/billing untuk memastikan akses API tanpa gangguan.
Di mana presentasi yang dibuat oleh API muncul di dashboard Gamma?
Presentasi yang dibuat melalui API muncul di bagian API Generated di dashboard Gamma, bukan di daftar Gammas utama Anda (Semua, Baru Dilihat, atau Dibuat oleh Anda).
Untuk membuat presentasi yang dibuat oleh API muncul di daftar Gammas biasa Anda, buka dan pilih Duplicate. Duplikat tersebut diperlakukan sebagai gamma standar yang dibuat melalui web dan akan muncul di semua tampilan biasa.