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

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パラメーターとそれがプレゼンテーション生成に与える影響の詳細については、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として扱われ、通常のすべてのビューに表示されます。

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