Gamma APIとは何ですか？
お気に入りのデッキがありますか？それと同じものを世界中の異なるオーディエンス向けに100個作成できたらどうでしょう？
Gamma Generate APIを使えば、Gammaアプリを直接使わずにプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿をプログラムで作成できます。Zapier、Make、n8nなどのツールでワークフローを自動化したいユーザーや、自分のアプリに美しいプレゼンテーション生成を統合したい方、バックエンドコードで大規模にプレゼンテーションを作成したい方に最適です。
開発者の方は、Gammaをアプリケーションに統合してデザインのスーパーパワーを付与できます！
💎 プロのヒント：誰でも無料プランを含むどのプランでも、寛大な使用制限で今日からAPIにアクセスできます。
APIは準備できていますか？
Gamma API v1.0は2025年11月5日から一般提供（GA）されています。誰でもどのプランでも寛大な使用制限でAPIにアクセス可能です。
特定のAPIパラメータやプレゼンテーション生成への影響については、APIドキュメントを参照してください。
アクセス方法は？
Gamma APIにアクセスするには、以下の手順に従ってください。
ステップ1：APIキーを生成する
アカウントの設定 and メンバーに移動し、API keyタブを開きます。Create API keyをクリックしてキーを生成し、コピーして安全に保管してください。
🔷 注意：APIキーはsk-gamma-xxxxxxxx形式で、X-API-KEYヘッダーで渡す必要があります（Bearerトークン形式ではありません）。
💎 プロのヒント：お気に入りの自動化ツールでAPIを使い始めるか、バックエンドコードに直接統合しましょう。ベースURLはhttps://public-api.gamma.app/v1.0/です。
APIキーの代わりにOAuthで認証できますか？
Gamma REST APIは静的なAPIキーの代わりにOAuth 2.0で認証できます。OAuthは長期間有効なAPIキーを作成・保存せずにGamma APIをアプリに接続でき、統合やパートナーアプリに便利です。静的APIキーも引き続き完全にサポートされているため、X-API-KEYヘッダーを使い続けることも可能です。OAuthの設定は開発者ドキュメントのAuthenticate with OAuthガイド（developers.gamma.app/get-started/authenticate-with-oauth）を参照してください。
使用量とレート制限
現在のAPI制限
GammaのAPIはニーズに合わせてスケールします。数件のプレゼンテーションから数百件まで、通常の使用では制限に達することなく作成可能です。
🌀 インサイト：レート制限（HTTP 429エラー）が発生した場合はサポートチームに連絡してください。APIがあなたの構築をサポートできるよう対応します！
APIでできること
Gamma APIはgammaの作成からエクスポートまでの全ライフサイクルをカバーします。
コンテンツ生成：自分のテキストからプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成。
テンプレートから作成：Gammaで作成したテンプレートから新しいgammaを生成し、レイアウトやカード構造を保持。
既存のgamma編集：POST /v1.0/agent/gammas/{gammaId}/editsで自然言語による1ページの変更を適用。
エージェント生成：POST /v1.0/agent/generationsでワークスペーステンプレート、既存gamma、公式Gammaテンプレートから生成開始。
既存gammaの読み取り、エクスポート、分析：取得、コメント、エクスポート、分析用エンドポイント。
単独画像生成：フルgammaとは別に個別画像を生成。
ウェブページ形式：プレゼンテーション、ドキュメント、ソーシャル投稿に加えウェブページも生成。
ヘッダーとフッターのカスタマイズ：コンテンツのヘッダーとフッターをカスタマイズ。
入力内の画像URL：コンテンツ内で画像を直接参照。
フォルダー整理：生成したコンテンツをフォルダーに整理。
メール共有：コンテンツをプログラムでメール共有。
リストAPI：テーマとフォルダーを一覧表示するエンドポイント。
gamma検索：アクセス可能なgammaのタイトルと本文を検索し、結果を絞り込んで開く前にフィルター可能。
寛大な入力制限：最大100,000トークン（約400,000文字）。
APIで単独画像を生成できますか？
Gamma APIおよびModel Context Protocol（MCP）を使って単独画像を生成できます。これにより、プレゼンテーション、ドキュメント、ウェブページ全体を生成するのとは別に、個別画像をプログラムで作成可能です。APIまたはMCPで画像生成するには、開発者ドキュメントのCreate image generationガイドを参照してください。MCP経由の画像生成はClaude、ChatGPT、その他のMCPクライアントで利用可能です。
APIまたはMCPでgammaを検索できますか？
Gamma APIまたはModel Context Protocol（MCP）で接続されたAIアシスタントを通じて、全gammaライブラリを検索できます。検索はアクセス可能なすべてのgammaのタイトルと本文を対象にし、関連性順に結果を表示します。各結果には直接リンクが含まれ、レスポンスから直接gammaを開けます。
作成者や最終更新日時で検索を絞り込めます。アーカイブ済みgammaはデフォルトで除外され、含めることも可能です。
検索パラメータの全リストと例は、開発者ドキュメントのSearch gammasガイド（developers.gamma.app/management/search-gammas）を参照してください。
APIは何に使えますか？
Gamma APIはMake、Zapier、Workatoなどの自動化プラットフォームやワークフローツールに活用できます。バックエンドコードに直接統合してカスタムアプリを構築したり、複数のプレゼンテーションをプログラムで一括生成したり、パーソナライズされたコンテンツを大規模に作成したりできます。
🔷 注意：inputTextにはスライドに表示したい実際のコンテンツを含めてください。プレゼンテーションの作成方法に関する指示は含めないでください。テーマはGammaで事前作成し、IDで参照する必要があります。inputTextで作成はできません。
テンプレートサポート
「テンプレート」はユーザーによって意味が異なるため、利用可能な内容を説明します。
ビジュアルテーマ：Gammaでカスタムテーマを作成し、そのテーマIDをAPIで参照することで、プレゼンテーションの見た目や雰囲気を定義できます。利用可能なテーマIDはList Themes API（GET /v1.0/themes）で取得してください。
コンテンツ構造テンプレート：Create from templateを使用します。Gammaでテンプレートを作成し、そのIDとプロンプトを使ってPOST /v1.0/generations/from-templateを呼び出します。テンプレートのレイアウトとカード構造はデフォルトで保持され、プロンプトで内容、対象、言語を変更できます。テンプレートはワークスペースの単一ページのgammaでなければなりません（1ページに複数カード可能）。テンプレートIDはGET /v1.0/templates/searchで見つけられます。
エージェント生成：POST /v1.0/agent/generationsはワークスペーステンプレート、既存のgamma、または公式Gammaテンプレート（templateId）からも開始できます。
ヘルプとサポートの取得
ドキュメントとリソース
完全な技術リファレンスについては、開発者ドキュメントをご覧ください。APIアクセスはFreeを含むすべてのプランに含まれています。
デバッグ支援
APIの問題で助けが必要な場合は、まず一般的な問題と解決策をまとめたエラー文書を確認し、その後カスタマーサポートにお問い合わせください。問い合わせ時には必ずAPIレスポンスのx-request-idを含めてください。
すべてのAPIレスポンスにはヘッダーにこの一意の識別子が含まれています。**Make.comユーザー**はOutput → Bundle → Headersで確認できます。Zapierの場合は、成功した実行はRun Details → Data Outセクション、失敗したリクエストはLogsタブ → Response information（ヘッダー展開）で確認してください。
💎 プロのヒント：サポートを依頼する際は、必ずリクエストID、正確なエラーメッセージ、リクエストボディのサンプルを含めてください。
サポート範囲
対応可能な内容
Gamma固有のAPI問題、認証やAPIキーの問題、エラーメッセージの理解、レート制限の質問、クレジット使用に関する質問に対応可能です。
対応不可の内容
カスタムコードのデバッグや作成、Zapier、Make、N8Nでの完全なワークフロー構築、カスタムアプリケーションのデバッグ、Zapier、Make、N8Nの使用方法の指導、カスタムアーキテクチャの設計は対応できません。
APIサポートを依頼する際は、リクエストID、エラーメッセージ、リクエストボディのサンプル、使用している自動化プラットフォームを提供してください。
一般的なエラーコード
401 Unauthorized: 無効なAPIキーです。X-API-KEYヘッダー（AuthorizationやBearerではなく）を使用していることを確認してください。
403 Forbidden: クレジット残高を確認し、自動チャージが有効になっていることを確認してください。
429 Too Many Requests: レート制限に達しました。より高い容量オプションについてはSlackサポートにお問い合わせください。
422 Failed: 生成が完了できませんでした。入力パラメータを確認してください。
始め方のヘルプが必要ですか？
基本的なトラブルシューティングや一般的なAPI問題については、包括的なトラブルシューティングガイドをご覧ください。詳細なAPIリファレンスや例については、開発者ドキュメントもご確認いただけます。
➡️ 開発者ドキュメントを読む
よくある質問と一般的な問題
既存のgammaをAPIで編集できますか？
はい。
POST /v1.0/agent/gammas/{gammaId}/editsは、例えば「新しい料金プランで価格カードを更新する」といった自然言語の指示を、編集可能なgammaの1ページに適用します。結果は
GET /v1.0/agent/edits/{editId}でポーリングしてください。編集ではページの追加はできず、1ページに対して同時に1つの編集のみ実行されます。
同じ機能はClaude、ChatGPT、Slack、その他のMCPクライアントでも利用可能です。
自分のAIエージェントでGammaを使えますか？
はい。任意のMCPクライアントを
https://mcp.gamma.app/mcpに接続し、Gammaアカウントでサインインしてください。すべてのプランで利用可能です。カスタムクライアントは最初にOAuthリダイレクトURIを登録する必要があります。
APIキーを他人と共有できますか？
APIキーは安全に保管し、共有しないでください。
必要に応じて異なる用途ごとに別々のキーを生成してください。
なぜAPIキーを再度コピーできないのですか？
セキュリティ上の理由から、APIキーは生成時に一度だけ表示されます。
キーを紛失した場合は、新しいキーを生成する必要があります。
複数のAPIキーを生成できますか？
はい、アカウント設定から異なるプロジェクトや用途ごとに複数のAPIキーを作成できます。
APIやMCPの検索結果に表示されるgammaはどれですか？
検索結果には、すでにアクセス権のあるgammaのみが返され、Gammaで開けないコンテンツは決して表示されません。
結果は関連性順にランク付けされ、クエリに最も近い一致が最初に表示されます。
アーカイブされたgammaは、含める選択をしない限り除外されます。
作成者や最終更新日時でフィルターをかけることもできます。
なぜ私のワークスペースで検索が機能しないのですか？
あなたのgammas全体での検索は段階的に展開されており、まだすべてのワークスペースで有効になっていません。
利用できない場合は、カスタマーサポートに連絡し、
x-request-idを含めてワークスペースを確認できるようにしてください。編集者：検索が100％確認されたらこのFAQを削除してください。
クレジットがなくなったらどうなりますか？
中断のないAPIアクセスを確保するために、gamma.app/settings/billingの請求設定で自動チャージを有効にしてください。
APIで生成されたプレゼンテーションはGammaダッシュボードのどこに表示されますか？
API経由で作成されたプレゼンテーションは、GammaダッシュボードのAPI Generatedセクションに表示され、メインのGammasリスト（すべて、最近閲覧、またはあなたが作成したもの）には表示されません。
APIで生成されたプレゼンテーションを通常のGammasリストに表示させるには、それを開いてDuplicateを選択してください。複製は標準のウェブ作成gammaとして扱われ、通常のすべてのビューに表示されます。