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

Gamma API トラブルシューティング

サポート範囲、一般的なエラーコード、およびトラブルシューティング手順。

Gamma API トラブルシューティングガイド

APIに関するすべての問題をサポートしたいですが、当社のサポートチームはワークフローの構築、バックエンドコード(FastAPI、Express、Djangoなど)のデバッグ、プラットフォーム固有の問題のトラブルシューティングは対応できません。

当社はGamma固有のエンドポイントやパラメータ、API認証、エラーのトラブルシューティング、クレジット、リクエストがドキュメントに合致しているかの確認については対応可能です。

プラットフォーム固有のサポートはZapier Support、Make Support、またはN8N Supportにお問い合わせください。

GammaのAPIの詳細はdevelopers.gamma.appをご覧ください。


一般的なエラーコード

400 Bad Request

無効なパラメータ

リクエストを以下の点で確認してください:

  • 必須フィールドの欠落(inputText、textMode)

  • 無効なパラメータ値

  • 文字数/トークン制限超過

エラーメッセージで具体的な検証内容を確認してください。


401 Unauthorized

無効なAPIキー

APIキーが無効か、Proアカウントに紐づいていません。

  1. X-API-KEYヘッダー(Authorizationではなく)を使用していることを確認してください。

  2. 新しいAPIキーはgamma.app/settings/billingで生成してください。

  3. アカウントが有効なPro、Ultra、Teams、またはBusinessプランであることを確認してください。


403 Forbidden

クレジットがありません

アカウントのAPIクレジットがなくなりました。

gamma.app/settings/billingで対処してください。

  • 自動チャージを有効にする(推奨)

  • 必要に応じてクレジットを購入する

  • 上位プランにアップグレードする


404 Not Found

無効なgeneration ID

generation IDが存在しないか、別のユーザーのものです。

POSTレスポンスの正しいgenerationIdを使用しているか確認してください。


422 Failed

生成が完了しませんでした

生成結果が空でした。

リクエストを確認してください:

  • inputTextに十分な内容があることを確認する

  • パラメータが入力内容に合っているか確認する

  • 必要に応じて複雑な指示を簡素化する


429 Too Many Requests

レート制限超過

レート制限(1時間あたり50生成)に達しました。

注意:APIは十分な容量があります。ほとんどのユーザーは通常の使用でこの制限に遭遇しません。

解決策:

  1. より高い容量が必要な場合はGamma Supportに連絡してください。

  2. 指数的バックオフを実装する

  3. リクエストを時間的に分散する


500 Internal Server Error

予期しないサーバーエラー

一時的なサーバーの問題が発生しました。

  1. しばらく待ってから再試行してください。

  2. 問題が続く場合はx-request-idを添えてサポートに連絡してください。


502 Bad Gateway

一時的なゲートウェイの問題

一時的な接続の問題が発生しました。

しばらく待ってからリクエストを再試行してください。



APIで生成されたプレゼンテーションがGammasリストに表示されない

APIで生成されたプレゼンテーションはGammaダッシュボードのAPI Generatedセクションに表示され、メインのGammasリスト(All、Recently Viewed、Created by You)には表示されません。これは仕様です。プレゼンテーションの名前を変更しても分類は変わりません。

回避策:プレゼンテーションを開き、Duplicateを選択してください。複製は通常のウェブ作成Gammaとして扱われ、メインのGammasリストに表示されます。

まだお困りですか?

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