メインコンテンツまでスキップ

エラー修正

症状と HTTP ステータスから原因を確認し、最小の修正を検証してから段階的にリクエストを復旧します。

401 認証エラー​

  • 症状： 通常は 401 認証エラー が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： Key がない、無効、不完全、または認証ヘッダーがプロトコルと異なります。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： Key を再コピーして前後の空白を除き、Bearer、x-api-key、x-goog-api-key を確認します。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

403 アクセス不可​

  • 症状： 通常は 403 アクセス不可 が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： 現在の Key、アカウント状態、モデル権限ではリクエストできません。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： Key が有効か確認し、モデルと料金ページから現在利用可能なモデルを選び直します。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

404 見つからない​

  • 症状： 通常は 404 見つからない が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： Base URL、プロトコルパス、HTTP メソッドが一致しないか、/v1 が二重です。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： 完全なメソッドとパスをガイドと照合し、指定された階層だけを Base URL に入力します。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

429 リクエスト過多​

  • 症状： 通常は 429 リクエスト過多 が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： 短時間のリクエストが多いか、現在利用可能な残高が不足しています。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： 同時実行数を減らし、待機時間を延ばしながら再試行し、ポータルでアカウント状態を確認します。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

5xx サービスエラー​

  • 症状： 通常は 5xx サービスエラー が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： 上流サービスまたはゲートウェイが一時的に処理できません。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： 発生時刻とステータスを保存して後で再試行します。継続する場合は最小 curl でクライアント設定を切り分けます。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

ネットワーク切断​

  • 症状： 通常は ネットワーク切断 が返り、クライアントには「リクエスト失敗」だけが表示されることもあります。
  • 原因： ローカル回線、プロキシ、長時間接続が応答完了前に切れました。
  • 確認：
    1. HTTP ステータス、パス、発生時刻を記録します。
    2. Key を再コピーし、空白、期限、無効化状態を確認します。
    3. ガイドと URL、モデル、認証ヘッダーを照合し、最小 curl で検証します。
  • 対処： ドメインへの到達を確認し、ストリームはバックオフ再接続します。非冪等操作は自動再送しません。
  • 検証： 修正後は短いテキストを一つ送信し、正常な JSON が返ってから元の高度な設定を戻します。

推奨する切り分け順序​

  1. 最初に HTTP ステータス、リクエストパス、クライアント、発生時刻を記録します。
  2. クイックスタートの最小 curl で再現し、Key、モデル、URL、クライアントのどこに問題があるかを分けます。
  3. 一度に一つだけ変更します。ストリーミング、ツール、メディア設定を戻す前に短いテキストで確認します。

解決しない場合​

時刻、プロトコル、HTTP メソッド、パス、ステータス、機密部分を除いた応答を保存します。完全な Key は含めません。

動画エラーの切り分け​

送信前、PopGo解析、受付、照会、取得のどこかを特定。エラー語句を保存し500やログなしだけで判断しません。

段階対処
first-frame requires exactly one / first-last-frame requires bothモード、1画像または別々の2スロット、入力辺、実数を確認
reference-audio requires at least one / audio not supported能力と音声添付許可を確認し音声を追加；generate_audioは入力許可ではない
unsupported protocol: data / invalid sourceURL限定モデルは許可公開URLへ。ローカル表示はファイル公開ではない
長い0% / completed後取得失敗既存idを照会し内容準備を待ち、再作成しない
成功しても素材無視欄・取得可否・最終媒体を確認；HTTP200だけでは不足

400は通常入力修正、500は解析や中間層の可能性、503は一時容量不足がよくある原因です。匿名化した詳細を確認。動画の診断に照会・費用・証拠の範囲があります。