エラーメッセージ

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

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

「API are limited to API calls per domain at the same time.」エラーメッセージ

「Calls to this api have exceeded the rate limit: API are limited to API calls per domain at the same time.」というエラーメッセージが表示されます。

原因

CLOVA OCRモデルで可能な同時リクエスト数を超過しました。

解決方法

General OCRモデルの同時リクエスト数を増設する必要がある場合、ドメイン ID、月間予想使用量、流量増設の目的をカスタマーサポートに送信してください。ただし、Document OCRモデルは空き容量によっては同時リクエスト数の増設が困難な場合があります。

「NOT_FOUND: not found matched template」というエラーメッセージ

multiform dataで APIを呼び出す際に 「NOT_FOUND: not found matched template」というエラーメッセージが表示されます。

原因

• 使用した画像が登録したテンプレートと一致しない場合、当該エラーが発生する場合があります。
• リクエストボディに templateIdsを誤って指定した場合、当該エラーが発生する場合があります。
• Template OCRで使用した画像と一致するテンプレートが見つからない場合、当該エラーが発生する場合があります。

解決方法

• リクエストボディの templateIds値をご確認ください。
• 利用中のテンプレートと呼び出しに使用した画像が同じフォーマットであるかをご確認ください。
• 問題が持続的に発生する場合、テンプレートで使用した画像、テンプレート設定画面、実際の呼び出し時に使用した画像をカスタマーサポートに送信してください。

「Not Found Deploy Info: Please confirm the template is released」というエラーメッセージ

「Not Found Deploy Info: Please confirm the template is released.」というエラーメッセージが表示されます。

原因

リリースが行われていない場合に発生します。

解決方法

Template OCRで登録したテンプレートを利用するには、画面左上の リリース管理 メニューから、登録したテンプレートに対してベータリリースとサービスリリースを順にリリースする必要があります。ベータリリースを実行したかをご確認ください。
詳細は、リリース管理をご参照ください。

「Recognition failure」というエラーメッセージ

「Recognition failure」エラーメッセージが表示されます。

原因

画像認識に失敗した際に表示されるエラーメッセージです。

解決方法

• 呼び出しに使用した画像を変更します。画像に背景が含まれている場合は、認識が必要な部分のみを残すように画像を切り取り、再度呼び出します。
• 問題が持続する場合、呼び出しに使用した画像の拡張子を txtに変更し、カスタマーサポートに送信してください。

「Request invalid: Request data is invalid」というエラーメッセージ

「Request invalid: Request data is invalid.」というエラーメッセージが表示されます。

原因

不正なリクエストボディで APIを呼び出した場合に発生します。

解決方法

• 呼び出すコードを確認し、リクエストボディを適切に変更します。
• NAVERクラウドプラットフォームではコードのレビューはサポートされていないため、CLOVA OCR APIガイドを参照し、APIリクエスト例と使用したコードとの違いを検討します。

「Request invalid.unsupported file format」というエラーメッセージ

「Code」: 「0011」というエラーメッセージが表示されます。
"message": "Request invalid.unsupported file format."というエラーメッセージが表示されます。

原因

• 外部 URLの場合、画像情報を取得できる公開 URLである必要があります。
• フィールド値の形式にエラーがある場合、発生します。

解決方法

• 外部 URLの場合、画像を取得できる公開 URLであるかを確認します。
• Content-Typeが application/jsonの場合、imagesフィールドで呼び出し、imageフィールドは format、name、dataで構成されます。dataフィールドには Base64エンコードされた画像データを適用します。CLOVA OCR APIガイドで提供される形式に従って呼び出します。

「Please confirm the template is released」というエラーメッセージ

「Not Found Deploy Info: Please confirm the template is released」というエラーメッセージが表示されます。

原因

テンプレートがベータリリースのみ完了し、サービスリリースが完了していない場合に発生するエラーです。

解決方法

サービスリリースを完了すると、APIを呼び出せます。サービスリリースを実行します。

「Secret validate failed」というエラーメッセージ

「Secret validate failed」というエラーメッセージが表示されます。

原因

入力した Secret Keyが検証されていない場合に発生します。

解決方法

• リクエスト時に送信されたヘッダー情報がドメインテンプレートビルダー > [API Gateway連携] タブ > [連携] タブで作成したヘッダ情報と一致しているかを確認します。
• クライアント環境において、ヘッダー情報が正しく送信されているかを確認します。
• レスポンスステータスコード別の説明は、CLOVA OCR APIガイドをご参照ください。