Gamma API トラブルシューティングガイド
APIに関するすべてのことをお手伝いしたいですが、サポートチームはワークフローの構築、バックエンドコード（FastAPI、Express、Djangoなど）のデバッグ、プラットフォーム固有の問題のトラブルシューティングはできませんのでご了承ください。
Gamma固有のエンドポイントやパラメータ、API認証、エラーのトラブルシューティング、クレジット、リクエストがドキュメントに合っているかの確認については対応可能です。
プラットフォーム固有のサポートはZapier Support、Make Support、またはN8N Supportにお問い合わせください。
GammaのAPIの詳細は、こちらをご覧ください：developers.gamma.app
一般的なエラーコード
400 Bad Request
無効なパラメータ
リクエストを確認してください:
必須フィールドが欠落しています（
inputText、textMode）。パラメータの値が無効です。
文字数またはトークンの制限を超えています。
from-templateの場合：テンプレートは単一ページのworkspace gammaでなければなりません。公式Exploreテンプレートや複数ページのgammaは拒否されます。
具体的な検証の詳細はエラーメッセージを確認してください。
401 Unauthorized
無効なAPIキー
APIキーが無効であるか、Proアカウントに紐づいていません。
X-API-KEYヘッダー（Authorizationではなく）を使用していることを確認してください。新しいAPIキーはgamma.app/settings/api-keysで生成してください。
アカウントが有効なPro、Ultra、Teams、またはBusinessプランであることを確認してください。
403 Forbidden
クレジットが利用できません
アカウントのAPIクレジットがなくなっています。
こちらで対処してください：gamma.app/settings/billing
自動チャージを有効にする（推奨）。
必要に応じてクレジットを購入する。
より上位のプランにアップグレードする。
404 Not Found
無効なgenerationまたはgamma ID
generation IDが存在しないか、別のユーザーに属しています。このエラーは、既存のgammaを読み取り、編集、またはエクスポートする際にアクセスできないgamma IDの場合にも返されます。
POSTレスポンスの正しいgenerationIdを使用しているか、対象のgammaにアクセス権があるか確認してください。
422 Failed
generationが完了できませんでした
generationが空の出力を生成しました。
リクエストを確認してください:
inputTextに十分な内容があることを確認してください。パラメータが入力に合っているか確認してください。
必要に応じて複雑な指示を簡素化してください。
429 Too Many Requests
レート制限超過
レート制限に達しました。制限はAPIキー所有者ごとおよびworkspaceごとに設定されており、現在の値はエラーコードのリファレンスに記載されています。
🔷 注意：APIは十分な容量を持っています。ほとんどのユーザーは通常の使用でこの制限に遭遇しません。
解決策：
より高い容量が必要な場合はGamma Supportに連絡してください。
指数的バックオフを実装してください。
リクエストを時間的に分散させてください。
500 Internal Server Error
予期しないサーバーエラー
一時的なサーバーの問題が発生しました。
少し待ってから再試行してください。
問題が続く場合は、
x-request-idを添えてサポートに連絡してください。
502 Bad Gateway
一時的なゲートウェイの問題
一時的な接続の問題が発生しました。
少し待ってからリクエストを再試行してください。
APIで生成されたプレゼンテーションがGammasリストに表示されない
APIで生成されたプレゼンテーションはGammaダッシュボードのAPI Generatedセクションに表示され、メインのGammasリスト（All、Recently Viewed、Created by You）には表示されません。これは想定された動作であり、プレゼンテーションの名前を変更しても分類は変わりません。
回避策：プレゼンテーションを開き、Duplicateを選択してください。複製は通常のウェブ作成gammaとして扱われ、メインのGammasリストに表示されます。
まだお困りですか？
一般サポート： Gammaサポートへの連絡方法。
APIコミュニティ： Gamma API Slackに参加。
SSOの問題： 組織のIT管理者に連絡してください。