Machine Translation (MT)

There are two types of MT in VNTranslator:

1. Machine Translation via Web Scraping in Web Browser

2. Machine Translation via API using GET/POST methods

---

1. Web Scraping in Web Browser

Machine translations using this method include Google Lite, Google Web, DeepL Web, Bing, Papago, and others.

In this section, I will explain in detail the common issues related to Translation Timeout.

Translation Timeout occurs when the DOM API cannot find a match on the website within the specified time limit.

By default, the Timeout for translation requests is 10.000 ms (10 seconds)

1.1 Unstable Connection

An unstable connection can cause the webpage to fail to load properly

1.2 Client IP Blocked / Too Many Requests

This issue often arises if there are too many requests or the requests are sent too quickly.

• Clear cookies & site data in VNTranslator

• Set up and use a VPN

By default, the request delay is set to 50ms, but you can increase this delay to 100ms - 500ms if this issue frequently occurs.

Based on my testing:

• DeepL Web will not respond if requests exceed 1600 per hour

• Google Lite / Google Web will display a captcha if requests exceed 1250 per minute

1.3 Captcha Verification / Cookie Banner

• Complete the captcha verification and accept/reject the cookie banner in the Browser Window

1.4 Website Updated

If the website has been updated, the script in VNTranslator may need to be updated.

You can check this in the Browser Window when the page loads. If the text is translated correctly but VNTranslator still shows a Translation Timeout, it is likely that the website structure has been updated.

• For the PRO version, check for machine translation updates in the Settings (Go to Settings -> MT Engines -> Updates)

• For the public version, check on Discord in the #custom-mt channel for translator updates

---

2. API

DeepL API Free/Pro

• https://support.deepl.com/hc/en-us/articles/9773964275868-DeepL-API-error-messages

Error Code

400

Bad request. Please check error message and your parameters

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.

Error Code

403

Authorization failed. Please supply a valid auth_key parameter

This error occurs when the API key in the request is either missing or incorrect.

For the API key to be valid, your subscription must be active. You can check your API key and the status of your subscription in your DeepL account, under API keys.

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. The authentication key for CAT tools is included in the DeepL Pro Advanced and DeepL Pro Ultimate subscription plans.

Error Code

404

The requested resource could not be found

This error occurs when the URL is wrong. Please check the path of the URL.

Error Code

413

The request size exceeds the limit

This error occurs when the request size reaches the supported limit.

Error Code

414

Request-URI Too Long

This error occurs if the API URLs are too long and is due to a length limit of the web server. You can avoid this error message by using a POST request instead of a GET request.

Error Code

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.

Sending less text in a single request may reduce the likelihood of this error.

Error Code

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 account and increase the limit if necessary.

Error Code

5**

Internal error

Any error starting with 5 is an internal error. If you get error 503, please wait and try again later. If you get any other error, please contact DeepL Support.

Google API

• https://cloud.google.com/apis/design/errors

OpenAI API

• https://platform.openai.com/docs/guides/error-codes/api-errors