pyVideoTrans

English

简体中文

English

简体中文

Appearance

When using video translation software, you may frequently encounter errors, such as those in the title and the ones shown in the images below.

The error messages often include the following characters:

HTTPSConnection

Connection error

ConnectionError

HTTPSConnectionPool

Max retries exceeded with url

These errors mainly occur in the following three scenarios:

  • When selecting Google/OpenAI ChatGPT/Gemini/ in the translation channel.

  • When selecting OpenAI TTS/Elevenlabs.io/GoogleTTS in the dubbing channel.

  • When selecting OpenAI Recognition API/ in the speech recognition settings.

Why does this happen? Here are the main reasons:

Services Unavailable in Mainland China Require a VPN, Otherwise Errors Are Inevitable ​

From the three scenarios above, it's clear that these services require connecting to foreign APIs. Due to internet restrictions in mainland China, these services are not directly accessible. To use them, you must employ a VPN. If you cannot access the Google website (https://www.google.com) or the OpenAI official website (https://chat.openai.com) directly from your device, errors are bound to occur.

Incorrect Proxy Settings Even with a VPN Enabled ​

If your device can access Google normally but the translation software still reports errors, check the Network Proxy text box in the software interface. If there is content in it and you are unsure of its meaning or purpose, or if you did not intentionally add it, delete the content and try again.

If the issue persists, check your VPN tool to find the HTTP proxy port number. If your VPN is running locally, enter http://127.0.0.1:port_number in the text box. For example, for V2Ray-based software, it is usually http://127.0.0.1:10809, and for Clash-based software, it is typically http://127.0.0.1:7890.

Important Note: If you do not understand the above instructions, delete all content in the Network Proxy text box and leave it empty. Do not enter anything. In other words, either leave it blank or ensure you enter a correct and functional proxy address.

Do not randomly enter content in the Network Proxy text box or input website addresses or API URLs. Either leave it blank or enter a valid proxy address and port.

The software automatically retrieves proxy settings from the system by default. If your device is already using a VPN, even if the Network Proxy text box is left empty, it should be able to access these services. However, this may fail due to permissions, security policies, security software, or firewall restrictions.

If your device can access the services without issues but the software still reports errors, enter the correct proxy address in the Network Proxy text box.

Domestic Translation and AI Services Do Not Support Access via Foreign Proxies or IPs ​

If you encounter network connection errors or unsupported authorization messages when using Baidu Translate/Tencent Translate/ByteDance Volcano Engine Translate/Doubao Model Recognition in the translation software, it may be because you are connecting using a foreign IP (e.g., via a VPN with foreign nodes or other proxy tools).

These domestic translation and AI services block access from foreign IPs. If you use a proxy to access these services, errors will occur. Simply delete the content in the Network Proxy text box and, if necessary, disable your VPN tool.