在本教學中，我們將引導你如何使用 .env 檔案設定 Azure 服務的環境變數。環境變數讓你能夠安全地管理敏感憑證，例如 API 金鑰，而不必將它們硬編碼在你的程式碼庫中。
[!IMPORTANT]
- 只需設定一種語言模型服務（Azure OpenAI 或 OpenAI）。請填寫你偏好的服務的環境變數。如果設定了多個語言模型的環境變數，協作翻譯器將根據優先順序選擇其中一個。
- 若未設定 Computer Vision 的環境變數，翻譯器將自動切換到 僅 Markdown 模式。
[!NOTE] 本指南主要聚焦於 Azure 服務，但你可以從支援的模型與服務清單中選擇任何支援的語言模型。
在你的專案根目錄中，建立一個名為 .env 的檔案。此檔案將以簡單的格式儲存你所有的環境變數。
[!WARNING] 請勿將 .env 檔案提交至像 Git 這類版本控制系統。請將 .env 加入你的 .gitignore 檔案，以防止意外提交。
移動至你的專案根目錄。
在專案根目錄建立 .env 檔案。
開啟 .env 檔案並貼上以下範本：
# Azure Credentials
AZURE_AI_SERVICE_API_KEY="your_azure_ai_service_api_key"
AZURE_AI_SERVICE_ENDPOINT="https://your_azure_ai_service_endpoint"
# Optional fallback set example (index 1)
AZURE_AI_SERVICE_API_KEY_1="your_azure_ai_service_api_key_1"
AZURE_AI_SERVICE_ENDPOINT_1="https://your_azure_ai_service_endpoint_1"
# Azure OpenAI Credentials
AZURE_OPENAI_API_KEY="your_azure_openai_api_key"
AZURE_OPENAI_ENDPOINT="https://your_azure_openai_endpoint"
AZURE_OPENAI_MODEL_NAME="your_model_name"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="your_deployment_name"
AZURE_OPENAI_API_VERSION="your_api_version"
# Optional fallback sets: duplicate the full AZURE_OPENAI_* set with suffix _1/_2 (same index for all variables)
# OpenAI Credentials
OPENAI_API_KEY="your_openai_api_key"
OPENAI_ORG_ID="your_openai_org_id"
OPENAI_CHAT_MODEL_ID="your_chat_model_id(ex. gpt-4o)"
OPENAI_BASE_URL="https://api.openai.com/v1 (If you don't have a custom base URL, you can delete this lin, then it will use the default base URL)"
# Optional fallback sets: duplicate the full OPENAI_* set with suffix _1/_2 (same index for all variables)
[!NOTE] 若想找到你的 API 金鑰與端點，可參考 set-up-azure-ai.md。
免責聲明：
本文件是使用 AI 翻譯服務 Co-op Translator 翻譯而成。雖然我們致力於確保準確性，但請注意，自動翻譯可能包含錯誤或不準確之處。原始文件的母語版本應被視為權威來源。對於重要資訊，建議尋求專業人類翻譯。我們不對因使用本翻譯而引起的任何誤解或誤釋負責。