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ステータスコードを参照するようにシステムを構成すると、安定した運用に役立ちます。