Gamma APIとは何ですか?
お気に入りのデッキがありますか?それと同じものを世界中の異なるオーディエンス向けに100個作成できたらどうしますか?
Gamma Generate APIを使うと、Gammaアプリを直接使わずにプログラム的にプレゼンテーション、ドキュメント、ウェブページ、ソーシャル投稿を作成できます。Zapier、Make、n8nなどのツールでワークフローを自動化したいユーザーや、美しいプレゼンテーション生成を自分のアプリに統合したい開発者、バックエンドコード統合で大規模にプレゼンテーションを作成したい方に最適です。
そして、開発者であれば、Gammaをアプリケーションに統合してデザインのスーパーパワーを与えることができます!
💎 プロのヒント:Proアカウント以上の方は、寛大な使用制限付きで今日からAPIにアクセスできます。
APIは準備できていますか?
Gamma API v1.0は2025年11月5日から一般提供(GA)されています。Proアカウント以上の方は、寛大な使用制限付きで今日からAPIにアクセスできます。
特定のAPIパラメーターとそれがプレゼンテーション生成に与える影響の詳細については、APIドキュメントを参照してください。
アクセス方法は?
Gamma APIにアクセスするには、以下の手順に従ってください。
ステップ1:アカウントをアップグレードする
Gamma Pro、Ultra、Team、またはBusinessアカウントが必要です。現在Proユーザーでない場合は、APIにアクセスするためにProにアップグレードしてください。
ステップ2:APIキーを生成する
Proアカウントの設定 and メンバーに移動し、API keyタブに進みます。Create API keyをクリックしてキーを生成し、APIキーをコピーして安全に保管してください。
🔷 注意:APIキーはsk-gamma-xxxxxxxx形式で、X-API-KEYヘッダーを使って渡す必要があります(Bearerトークン形式ではありません)。
💎 プロのヒント:お気に入りの自動化ツールでAPIを使い始めるか、バックエンドコードに直接統合してください。ベースURLはhttps://public-api.gamma.app/v1.0/です。
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があなたの構築をサポートできるよう対応します!
v1.0の新機能は?
API v1.0にはいくつかの強力な新機能が含まれています。
ウェブページ形式:プレゼンテーション、ドキュメント、ソーシャル投稿に加え、ウェブページも生成可能。
ヘッダーとフッターのカスタマイズ:コンテンツのヘッダーとフッターをカスタマイズ可能。
入力内の画像URL:コンテンツ内で画像を直接参照可能。
フォルダー整理:生成したコンテンツをフォルダーに整理可能。
メール共有:プログラム的にメールでコンテンツを共有可能。
リストAPI:テーマとフォルダーを一覧表示する新しいエンドポイント。
Gamma検索:アクセス可能なGammaのタイトルと本文を検索し、結果をフィルターして開く前に絞り込み可能。
入力制限の改善:最大100,000トークン(約400,000文字)。
🌀 インサイト:APIは進化し続け、Gammaをプログラム的に修正・リミックスするためのオプションを追加し続けます。
APIで単独の画像を生成できますか?
Gamma Generate APIとModel Context Protocol(MCP)を使って単独の画像を生成できるようになりました。これにより、プレゼンテーション、ドキュメント、ウェブページ全体を生成するのとは別に、個別の画像をプログラム的に作成できます。APIまたはMCPで画像を生成するには、開発者ドキュメントのCreate image generationガイド(developers.gamma.app/images/create-image-generation)を参照してください。MCP経由の画像生成はClaudeや他のMCPクライアントで利用可能ですが、ChatGPTではまだ利用できません。
APIまたはMCPでGammaを検索できますか?
Gamma APIまたはModel Context Protocol(MCP)を介してGammaに接続されたAIアシスタントから、Gammaのライブラリ全体を検索できます。検索はアクセス可能なすべてのGammaのタイトルと本文を対象に行い、関連性で結果をランク付けし、最も近い一致が最初に表示されます。各結果には直接リンクが含まれ、応答から直接Gammaを開けます。
作成者や最終更新日時で検索を絞り込むこともできます。アーカイブされたGammaはデフォルトで除外されますが、含めることも可能です。
🔷 注意:検索は段階的に展開されているため、すべてのワークスペースで利用できるわけではありません。検索エンドポイントやMCP検索ツールが機能しない場合は、ワークスペースにまだ展開されていません。
検索パラメーターの完全なリストとリクエスト例については、開発者ドキュメントのSearch gammasガイド(developers.gamma.app/management/search-gammas)を参照してください。
APIは何に使えますか?
Make、Zapier、Workatoなどの自動化プラットフォームでGamma APIを活用できます。また、バックエンドコードに直接統合してカスタムアプリを構築したり、複数のプレゼンテーションをプログラム的に生成して大量作成したり、パーソナライズされたコンテンツを大規模に作成したりできます。
🔷 注意:inputTextにはスライドに表示したい実際のコンテンツを含めてください。プレゼンテーションの作成方法に関する指示は含めないでください。テーマはGammaで事前に作成し、IDで参照する必要があります。inputTextで作成することはできません。
テンプレートサポート
「テンプレート」はユーザーによって意味が異なるため、利用可能なものを説明します。
ビジュアルテーマ:Gammaでカスタムテーマを作成し、そのテーマIDをAPIで参照してプレゼンテーションの見た目を定義できます。List Themes API(GET /v1.0/themes)で利用可能なテーマIDを取得してください。
コンテンツ構造テンプレート:今後のアップデートで厳密なコンテンツ構造サポートを追加予定です。
ヘルプとサポートの取得
ドキュメントとリソース
完全な技術リファレンスはAPIリファレンスドキュメントをご覧ください。概要と開始ガイドはランディングページもご確認ください。APIアクセスはPro、Ultra、Teams、Businessのサブスクリプションに含まれています。
デバッグヘルプ
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リファレンスと例は開発者ドキュメントをご覧ください。
➡️ 開発者ドキュメントを読む
よくある質問と一般的な問題
APIキーを他人と共有できますか?
APIキーは安全に保管し、共有しないでください。
必要に応じて異なる用途ごとに別々のキーを生成してください。
なぜAPIキーを再度コピーできないのですか?
セキュリティ上の理由から、APIキーは生成時に一度だけ表示されます。
キーを紛失した場合は、新しいキーを生成する必要があります。
複数のAPIキーを生成できますか?
はい、アカウント設定から異なるプロジェクトや用途ごとに複数のAPIキーを作成できます。
APIまたはMCPの検索結果に表示されるGammaはどれですか?
検索はすでにアクセス権のあるGammaのみを返すため、Gammaで開けないコンテンツは決して公開されません。
結果は関連性でランク付けされ、クエリに最も近い一致が最初に表示されます。
アーカイブされたGammaは、含める選択をしない限り除外されます。
作成者や最終更新日時でフィルターも可能です。
なぜ私のワークスペースで検索が機能しないのですか?
Gammaの検索機能は段階的に展開されており、すべてのワークスペースでまだ有効になっていません。
利用できない場合はカスタマーサポートに連絡し、
x-request-idを含めてワークスペースの状況を確認してください。
クレジットがなくなったらどうなりますか?
gamma.app/settings/billingの請求設定で自動チャージを有効にして、APIアクセスを途切れさせないようにしてください。
APIで生成されたプレゼンテーションはGammaダッシュボードのどこに表示されますか?
APIで作成されたプレゼンテーションはGammaダッシュボードのAPI Generatedセクションに表示され、通常のGammasリスト(すべて、最近閲覧、作成者別)には表示されません。
APIで生成されたプレゼンテーションを通常のGammasリストに表示させるには、それを開いてDuplicateを選択してください。複製は標準のウェブ作成Gammaとして扱われ、通常のすべてのビューに表示されます。
