メインコンテンツにスキップ

GammaにはAPIがありますか?

Gamma Generate APIでプログラム的にプレゼンテーションを作成 - 自動化、統合、ワークフロー、開発者向け

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として扱われ、通常のすべてのビューに表示されます。

こちらの回答で解決しましたか?