DeepL API

DeepL offers free API access that allows you to translate up to 500,000 characters per month for free. If you need more than that, you can purchase a DeepL API Pro subscription and it costs $5.49 / month + Usage based price

  • Copy the API key, then in the VNTranslator go to Settings → Translation → MT Engines → DeepL API (Pro or Free), and enter your key

DeepL API - Error Codes

  • 400 - Bad request This error occurs when a required parameter of the request is missing or one of the specified parameters is not supported, is misspelled, or the value is wrong.

  • 403 - Authorization failed This error occurs when the authentication key in the request is either missing or incorrect. For the authentication key to be valid, your subscription must be active. You can check your authentication key and the status of your subscription in your DeepL Pro Account, under Plan. Please also check that you have the correct subscription plan for the usage you require. To get access to DeepL's API, you need to subscribe to the DeepL API plan.

  • 404 - Not found. The requested resource could not be found

  • 414 - Request-URI Too Long

  • 456 - Quota exceeded. The character limit has been reached This error occurs when you reach your character limit. Please check the cost control settings in your DeepL Pro Account and increase the limit if necessary.

  • 429 - Too many requests. Please wait and resend your request When you receive this response, wait some time and try again. If you get the same error again, please wait longer between retries (e.g., double the wait time). Repeat this until the request succeeds. You can then gradually reduce the wait time again.

  • 5xx - Internal error Any error starting with 5 is an internal error. If you get error 503, please wait and try again later.

Last updated