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

よくあるエラーと復旧

HTTP ステータスとリクエストパスを記録してから対処します。

401 認証エラー

Key がない、無効、不完全、または認証ヘッダーがプロトコルと異なります。

Key を再コピーして前後の空白を除き、Bearer、x-api-keyx-goog-api-key を確認します。

403 アクセス不可

現在の Key、アカウント状態、モデル権限ではリクエストできません。

Key が有効か確認し、モデルと料金ページから現在利用可能なモデルを選び直します。

404 見つからない

Base URL、プロトコルパス、HTTP メソッドが一致しないか、/v1 が二重です。

完全なメソッドとパスをガイドと照合し、指定された階層だけを Base URL に入力します。

429 リクエスト過多

短時間のリクエストが多いか、現在利用可能な残高が不足しています。

同時実行数を減らし、待機時間を延ばしながら再試行し、ポータルでアカウント状態を確認します。

5xx サービスエラー

上流サービスまたはゲートウェイが一時的に処理できません。

発生時刻とステータスを保存して後で再試行します。継続する場合は最小 curl でクライアント設定を切り分けます。

ネットワーク切断

ローカル回線、プロキシ、長時間接続が応答完了前に切れました。

ドメインへの到達を確認し、ストリームはバックオフ再接続します。非冪等操作は自動再送しません。

解決しない場合

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