DeepL APIのエラーメッセージ

Bad request. Please check error message and your parameters

このエラーは、リクエストの必須パラメータが欠落している場合、または指定されたパラメータのいずれかが対応していない、スペルが間違っている、あるいは値が間違っている場合に発生します。

Authorization failed. Please supply a valid auth_key parameter

このエラーは、リクエスト内の APIキーが欠落しているか、または不正な場合発生します。

APIキーが有効であるためには、登録が有効である必要があります。APIキーおよび登録のステータスは、DeepLのアカウントの「APIキー」から確認できます。

ご利用目的に適したご登録プランを選択されているかご確認ください。DeepL APIにアクセスするには、DeepL APIプランにご登録いただく必要があります。「プランと価格のページ」をご覧いただき、翻訳支援ツール用の認証キーが含まれているプランをご確認ください。

The requested resource could not be found

このエラーは、URLが間違っている場合に発生します。URLのパスをご確認ください。 

The request size exceeds the limit

このエラーは、リクエストのサイズが対応する上限に達した場合に発生します。 

サイズ制限に関する詳細情報、特に文書ファイルの翻訳に関する情報については、API技術資料をご参照ください。

1回の翻訳リクエストで大量のテキストを翻訳しようとしている場合は、例：段落ごとに分割するなどして、複数のリクエストに分けることをご検討ください。

Request-URL Too Long

このエラーは、API URL が長すぎる場合に発生し、Webサーバーの長さ制限が原因です。GETリクエストの代わりに POSTリクエストを使用することで、このエラーメッセージを回避できます。

Too many requests. Please wait and resend your request

この応答が表示された場合は、しばらく待ってから再度お試しください。同じエラーが再度発生した場合は、再試行の間隔を長く（例：待機時間を 2 倍に）してみてください。リクエストが成功するまで、この操作を繰り返してください。その後、待機時間を徐々に短くしていくことができます。

1回のリクエストで送信するテキストの量を減らすことで、このエラーが発生する可能性を低減できる場合があります。

Quota exceeded. The character limit has been reached

このエラーは、文字数制限に達した場合に発生します。DeepLのアカウントの料金管理設定を確認し、必要に応じて制限値を引き上げてください。

Internal error

5で始まるエラーはすべて内部エラーです。エラー503が発生した場合は、しばらく待ってから再度お試しください。その他のエラーが発生した場合は、DeepLサポートまでご連絡ください。