クライアント共通エラー問題(4xx)

Prev Next

Classic/VPC環境で利用できます。

CLOVA Studioサービスの利用中に次のような問題が発生することがあります。問題ごとの原因と解決方法を確認し、適切に対処してください。

HTTPステータスコード コード メッセージ 原因 解決方法
400 40000 Bad request 無効なリクエスト API明細を確認してリクエスト構文をチェック
400 40000 Each user message can contain only one image ターンごとに画像を2つ以上含める ターンごとに画像を1つ含めるように変更
400 40001 Invalid parameter 無効なリクエストパラメータ パラメータのサポート範囲に合わせて値を調整するか、APIリクエスト形式のエラーを修正
400 40003 Context length exceeded 長すぎるリクエスト モデルが処理可能なトークン数を超えないように入力されたテキストの長さまたは含む画像数を調整するか、パラメータで Maximum tokensを下げてからリクエスト
400 40003 Image limit exceeded リクエストごとの最大画像数超過 リクエストごとに5つ以下の画像に変更
400 40004 Text empty 空のテキストでリクエスト リクエストボディで空の部分を埋めてからリクエスト
400 40005 Unavailable output 結果を提供できないリクエスト -
400 40009 Unsupported function サポートしない機能をリクエスト リクエスト構文の tuningTypeのサポート有無または Chat Completions /Completionsのサポート有無を確認
400 40009 Unsupported function サポートしないツール(tool)をリクエスト リクエスト処理が可能なツールを選択するか、リクエストでそのツールがサポートされているかどうかを確認
400 40009 Unsupported input format モデルがリクエストしたインプットタイプを処理できない場合 リクエストしたインプットタイプを処理できるモデルに変更するか、リクエストを変更
400 40055 Invalid response format schema サポートしない形式のレスポンススキーマ サポートする形式のレスポンススキーマに変更
400 40060 Unsupported image format サポートしない画像形式が含まれる BMP、PNG、JPG、JPEG、WEBP形式の画像に変更
400 40061 File size error サポートしていない画像サイズ 0Byte超過で20MB以下サイズの画像に変更
400 40063 Invalid image size 画像の長さ超過 横長、縦長のどちらか長い方は2240px以下、短い方は4px以上の画像でリクエスト
400 40063 Invalid image ratio 対応していないアスペクト比 アスペクト比が1:5または5:1以下の画像に変更
400 40063 Invalid image file 処理できない画像 正常な画像ファイルかどうか確認して再試行
400 40063 Invalid image url 画像が見つからない URL 正常に画像を取得できる URLかどうか確認して再試行
400 40063 Image download failed モデルが画像をダウンロードできない しばらくしてから再試行
400 40063 Image processing error モデルが画像処理できない しばらくしてから再試行
400 40080 Model not found モデルが見つからない モデル名を確認してからリクエスト
400 40082 Model fade out モデルサポート終了 サポートするモデルに変更してリクエスト
400 40083 Model no resource モデルに割り当てられたリソースなし 解約したか、契約終了ではないか確認
400 40084 Unsupported API for model この APIがサポートしないモデルでリクエストを送った場合 この APIがサポートするモデルに変更するか、モデルを使用できる APIに変更して再度リクエスト
401 40100 Unauthorized 認証失敗 ジョブの作成者とリクエスタの権限を確認
401 40101 Invalid signature 無効なリクエスト署名 有効な Client ID、ClientSecretでアクセストークンを再発行
401 40102 Invalid access token 無効なアクセストークン 有効な Client ID、ClientSecretでアクセストークンを再発行
401 40103 Access token expired アクセストークンが期限切れ アクセストークンを確認し、再発行
401 40104 Invalid key 無効な認証キー 有効な Client ID、ClientSecretでアクセストークンを再発行
401 40170 No subscription request history found. Please request a subscription to use CLOVA Studioの申し込み履歴が見つからない NAVERクラウドプラットフォームコンソールで CLOVA Studioサービスの申し込み有無を確認
403 40300 Forbidden サーバの作業拒否 リクエスト機能に対する使用権限を所有しているか確認
403 40301 No ownership 所有権なし リクエスト機能に対する使用権限を所有しているか確認
404 40400 Not found リクエストリソースが見つからない リクエスト構文が有効かどうか確認
404 40400 File not found Object Storageバケットでリクエストリソースが見つからない リクエスト構文(ファイルパス)が有効かどうか確認
406 40600 Not Acceptable 無効なメディア形式 メディア形式が有効かどうか確認
408 40800 Request timeout リクエスト処理時間超過 再度リクエスト
408 40800 Image I/O timeout モデルの画像ダウンロード時間超過 最大利用量を超えないようにリクエストを制御するか、再試行
413 41300 Request body size exceeded リクエストボディサイズ超過 50MB以下に変更してリクエスト
415 41500 MediaType error サポートしないメディア形式 メディア形式が有効かどうか確認
415 41501 No multipart boundary Content-Type multipartの使用が必要なのに形式に合わないリクエスト multipart使用時に必要な形式に変更してリクエスト
424 42400 Processing Failed リクエスト処理中に一部の項目に問題が発生 リクエスト形式の整合性を確認して再試行
429 42900 Too many requests 過剰なリクエスト 予め告知された利用量制御ポリシーに従って、設定された最大利用量を超えないようにリクエスト時レスポンスヘッダの関連情報を確認して最大利用量範囲以内に制御するか、Exponential backoffなどの方法で再試行処理
429 42901 Too many requests - rate exceeded 過剰なリクエスト(最大利用量超過) 予め告知された利用量制御ポリシーに従って、設定された最大利用量を超えないようにリクエスト時レスポンスヘッダの関連情報を確認して最大利用量範囲以内に制御するか、Exponential backoffなどの方法で再試行処理
429 42902 Too many requests - overloaded 過剰なリクエスト(トラフィック過多) : 限られた GPUインフラベースのコンピューティングリソースにより、ユーザーが設定された最大利用量以内でサービスを利用しても、インフラ状況やトラフィックによって処理遅延が発生したり、失敗することがある
429 42903 Too many requests - image queue 過剰な画像リクエスト(処理遅延) しばらくしてから再試行
参考

HTTPステータスコードを参照するようにシステムを構成すると、安定した運用に役立ちます。