Microsoft Translator API V3 Python 项目使用说明
1. 项目目录结构及介绍
项目目录结构如下:
MicrosoftTranslator/Text-Translation-API-V3-Python/
├── .gitignore
├── BreakSentence.py
├── Detect.py
├── DictionaryExample.py
├── DictionaryLookup.py
├── LICENSE.txt
├── Languages.py
├── README.md
├── Translate.py
├── Transliterate.py
├── settings.cmd
.gitignore
:用于Git版本控制时排除不需要提交的文件。BreakSentence.py
:用于断句的Python脚本。Detect.py
:用于检测文本语言的Python脚本。DictionaryExample.py
:字典示例Python脚本,具体功能未明。DictionaryLookup.py
:字典查找Python脚本,具体功能未明。LICENSE.txt
:项目使用的许可证文件。Languages.py
:包含支持语言的Python脚本。README.md
:项目说明文件。Translate.py
:执行文本翻译的Python脚本。Transliterate.py
:执行文本音译的Python脚本。settings.cmd
:配置命令文件,用于设置环境变量等。
2. 项目的启动文件介绍
项目的启动文件是 Translate.py
,该文件包含用于调用Microsoft Translator API进行文本翻译的核心代码。使用时需要先配置好环境变量,然后运行此脚本来进行翻译操作。
3. 项目的配置文件介绍
项目的配置主要是通过环境变量来完成的,需要在 .env
文件或直接在操作系统中设置以下环境变量:
TRANSLATOR_TEXT_SUBSCRIPTION_KEY
:Microsoft Translator服务的订阅密钥。TRANSLATOR_TEXT_REGION
:Microsoft Translator资源所在的Azure区域。TRANSLATOR_TEXT_ENDPOINT
:文本翻译服务的终结点。
在 settings.cmd
文件中可以找到设置这些环境变量的示例,但实际操作时应该在项目的根目录下创建一个 .env
文件,并在此文件中设置这些变量。例如:
TRANSLATOR_TEXT_SUBSCRIPTION_KEY=你的订阅密钥
TRANSLATOR_TEXT_REGION=你的Azure区域
TRANSLATOR_TEXT_ENDPOINT=你的文本翻译服务终结点
确保在运行任何Python脚本之前正确设置了这些环境变量。