ERRORS

エラー(401・402・403・429)の原因と対処

API が返すエラーの意味と、再試行してよいかの目安です。403 は課金されません。

更新 2026-10-12
目次

一覧

コード意味対処
401キーが無効、または入れ替えの猶予が切れたキーを確認する。必要なら再発行
403契約中のプランで使えない機能プランを確認する。課金されません
402当月の件数の上限を超えた利用量とプランを確認する
429短時間に多すぎるRetry-After の秒数だけ待って再試行
503処理の準備ができていない少し待って再試行

再試行してよいもの

429 と 503 は、待てば成功することがあります。401・403・402 は、再試行しても同じ結果です。原因を直してください。

判定の順番

401、403、402、429 の順に判定されます。403 は課金されず、402(月間の件数)は 429(秒間の上限)より先に判定されます。

要確認 当月の上限を超えたときの扱い(そのまま止めるか、超過分を課金するか)は、確定待ちです。現時点の API は、402 を返します。

詳しくは、エラーと、再試行と 429を参照してください。

STILL STUCK

解決しないときは、お問い合わせください。request_id をお知らせいただければ、住所の本文は不要です。