n8nのワークフローをGamma API v1.0に更新する方法
Gamma API v0.2は2026年1月31日に終了します。n8nのワークフローを新しいv1.0 APIに数分で移行する方法を、重要な変更点であるthemeNameからthemeIdへのパラメーター変更を中心に解説します。
重要なお知らせ:Gamma API v0.2の終了
n8nでGammaのAPIを使ってプレゼンテーションを自動生成している場合は、2026年1月31日までにワークフローを更新する必要があります。Gammaはv0.2のAPIエンドポイントを廃止する予定で、この日を過ぎると、古いバージョンを使っているワークフローは動作しなくなります。
朗報です。ソフトウェアの移行は簡単で、数分で終わります。このガイドでは、何を変更する必要があるのかを、順を追って説明します。
Gamma API v1.0での変更点
v1.0 APIで最も大きな変更は、テーマの指定方法です。人が読める形式のテーマ名ではなく、新しいAPIではテーマIDが必要になります。
従来の方法(v0.2):
“themeName”: “Oasis”
新しい方法(v1.0):
“themeId”: “theme_abc123xyz”
この変更により、APIの安定性が向上し、より正確にテーマを選択できるようになりますが、ワークフローを一度だけ更新する必要があります。
n8nユーザー向けの移行手順
ステップ1:n8nのワークフローを開く
n8nのインスタンスに移動し、Gamma APIを使っているワークフローを開きます。GammaへのAPI呼び出しを行うHTTP Requestノードを探します。
ステップ2:APIのURLを更新する
HTTP Requestノードで、URLを次のものから:
https://public-api.gamma.app/v0.2/generations
次のものに変更します:
https://public-api.gamma.app/v1.0/generations
ステップ3:GammaでテーマIDを取得する
ここが最も重要なステップです。テーマIDの見つけ方は次のとおりです。
- gamma.appでGammaのアカウントにログインします
- ナビゲーションバーのパレットアイコンをクリックして、デザインライブラリを開きます
- プレゼンテーションに使いたいテーマを見つけます
- テーマ名の横にある3つの点(⋯)をクリックします
- メニューから「Copy theme ID for API」を選びます
テーマIDがクリップボードにコピーされます。次のような形式です:theme_12345abcde
ステップ4:JSONペイロードを更新する
n8nのHTTP Requestノードで、JSONボディのセクションを探します。themeNameパラメーターをthemeIdに置き換えます。
変更前:
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeName”: “Oasis”, “numCards”: 10 }
変更後:
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “themeId”: “theme_12345abcde”, “numCards”: 10 }
ステップ5:保存してテストする
更新したワークフローを保存します。n8n v2.0以降を使っている場合は、新しいバージョンを公開します。v1.xの場合は、ワークフローを有効化します。
テスト実行をして、新しいAPIバージョンですべてが正しく動作することを確認します。
別の方法:Gammaのデフォルトテーマを使う
特定のカスタムテーマが不要な場合は、テーマのパラメーターを完全に削除すると、移行を簡単にできます。v1.0 APIは、Gammaの標準のデフォルトテーマを自動的に使います。
{ “inputText”: “Your presentation topic”, “format”: “presentation”, “numCards”: 10 }
ワークフローが複数ある場合は?
Gamma APIを使うn8nのワークフローが複数ある場合は、それぞれを個別に更新する必要があります。ただし、手順はどのワークフローでも同じです。
- APIのURLをv1.0に更新する
themeNameをthemeIdに置き換える- すべてのワークフローで同じテーマIDを使う(異なるテーマにしたい場合は、別のテーマIDを取得する)
テーマIDを1か所にまとめて記録しておくと、新しいワークフローを作るときに簡単に参照できます。
参考リソース
お困りの場合は
移行中に問題が起きたら、次の点を再確認してください。
- APIキーが変わっていないこと(同じままのはずです)
- Gammaから、テーマIDを最後までコピーしていること
- 正しいv1.0のエンドポイントURLを使っていること
- JSONの構文が正しいこと(カンマや引用符の抜けに注意してください)
2026年1月31日の期限が迫っているので、早めにワークフローを更新してください。移行は簡単で、完了すれば、プレゼンテーションの自動生成は、改善されたv1.0 APIで問題なく動き続けます。
About the author
Julian Pscheid is the founder and CEO of Hedy AI, a real-time AI meeting coach used by tens of thousands of professionals worldwide. He writes about how AI is changing the way people prepare for, capture, and understand important conversations.