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 v0.2は廃止予定で、2026年1月16日に終了します。現在v0.2を使用している場合は、この日までにv1.0に移行してください。
特定のAPIパラメーターとプレゼンテーション生成への影響についての詳細は、APIドキュメントを参照してください。
アクセス方法は?
Gamma APIにアクセスするには、以下の手順に従ってください。
ステップ1:アカウントをアップグレードする
Gamma Pro、Ultra、Team、またはBusinessアカウントが必要です。現在Proユーザーでない場合は、APIにアクセスするためにProにアップグレードしてください。
ステップ2:APIキーを生成する
Proアカウントの設定とメンバーに移動し、API keyタブを開きます。APIキーを作成をクリックしてキーを生成し、コピーして安全に保管してください。
🔷 注意: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があなたの構築をサポートできるよう対応します!
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)で接続されたAIアシスタントを通じて、Gammaのライブラリ全体を検索できます。検索はアクセス可能なすべてのGammaのタイトルと本文を対象に行い、関連性で結果をランク付けし、最も近い一致が最初に表示されます。各結果には直接リンクが含まれ、レスポンスから直接Gammaを開けます。
作成者や最終更新日時で検索を絞り込めます。アーカイブ済みのGammaはデフォルトで除外され、含めることも可能です。
🔷 注意:検索は段階的に展開中で、すべてのワークスペースで利用できるわけではありません。検索エンドポイントやMCP検索ツールが使えない場合は、まだワークスペースに展開されていません。
検索パラメーターの完全なリストとリクエスト例は、開発者ドキュメントのSearch gammasガイド(developers.gamma.app/management/search-gammas)を参照してください。
APIは何に使えますか?
Make、Zapier、Workatoなどの自動化プラットフォームでGamma APIを活用できます。バックエンドコードに直接統合してカスタムアプリを構築したり、複数のプレゼンテーションをプログラム的に生成して大量作成したり、パーソナライズされたコンテンツを大規模に作成したりできます。
🔷 注意:inputTextにはスライドに表示したい実際のコンテンツを含めてください。プレゼンテーションの作成方法に関する指示は含めないでください。テーマはGammaで事前に作成し、IDで参照する必要があります。inputTextで作成することはできません。
テンプレートサポート
「templates」はユーザーによって意味が異なるため、利用可能なものを説明します。
ビジュアルテーマ:Gammaでカスタムテーマを作成し、APIでテーマIDを使ってプレゼンテーションの見た目を定義できます。List Themes API(GET /v1.0/themes)で利用可能なテーマIDを取得してください。
コンテンツ構造テンプレート:今後のアップデートで厳密なコンテンツ構造サポートを追加予定です。
ヘルプとサポートの取得
ドキュメントとリソース
完全な技術リファレンスについては、API Referenceドキュメントをご覧ください。概要と開始ガイドについてはLanding Pageもご確認いただけます。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の検索結果に表示されるgammasはどれですか?
検索はすでにアクセス権のあるgammasのみを返すため、Gammaで開けないコンテンツは表示されません。
結果は関連性順にランク付けされ、クエリに最も近い一致が最初に表示されます。
アーカイブされたgammasは、含めることを選択しない限り除外されます。
作成者や最終更新日時でフィルターすることもできます。
なぜ私のワークスペースで検索が機能しないのですか?
gammasの検索機能は段階的に展開されており、すべてのワークスペースでまだ有効になっていません。
利用できない場合は、カスタマーサポートにお問い合わせの上、
x-request-idを含めてワークスペースを確認させてください。
v0.2からv1.0への移行は必要ですか?
はい、v0.2は2026年1月16日に終了します。
移行は簡単です:ベースURLを
/v0.2/から/v1.0/に更新してください。themeNameパラメーターをthemeIdに変更してください(IDはList Themes APIから取得)。入力制限を更新してください - v1.0は750k文字ではなく100kトークンを使用します。
v1.0のエンドポイントの詳細についてはAPIドキュメントを確認してください。
v0.2とv1.0の主な違いは何ですか?
v1.0ははるかに寛大なレート制限を提供します(1時間あたり数百回対1日50回)。
v1.0はウェブページ形式のサポートを含みます。
より良い入力制限(750k文字ではなく100kトークン)。
フォルダーの整理とthemesおよびfoldersのリストAPI。
クレジットがなくなったらどうなりますか?
gamma.app/settings/billingの請求設定で自動チャージを有効にして、APIアクセスを途切れさせないようにしてください。
API生成のプレゼンテーションはGammaダッシュボードのどこに表示されますか?
API経由で作成されたプレゼンテーションは、GammaダッシュボードのAPI Generatedセクションに表示され、メインのGammasリスト(すべて、最近閲覧、またはあなたが作成)には表示されません。
API生成のプレゼンテーションを通常のGammasリストに表示させるには、それを開いてDuplicateを選択してください。複製は標準のウェブ作成gammaとして扱われ、通常のすべてのビューに表示されます。
