Skip to content

Azure AI 設定

當您要設定 Azure OpenAI 以進行文字翻譯，以及使用 Azure AI Vision 提取影像文字時，請參考本指南。

先決條件

  • 一個 Azure 訂閱。
  • 具有建立或使用 Azure AI 資源與模型部署的權限。
  • Azure AI Foundry 中的一個專案，或等效的 Azure OpenAI 與 Azure AI Vision 資源存取權。

建立 Azure AI 專案

  1. 開啟 Azure AI Foundry。
  2. 建立或選擇一個專案。
  3. 為專案建立或選擇一個 AI 集線器。
  4. 建立完成後開啟專案概觀。

部署 Azure OpenAI 模型

  1. 在專案中，開啟 模型 + 端點 (Models + endpoints)。
  2. 選擇 部署模型 (Deploy model)。
  3. 選擇一個 GPT 模型，例如 gpt-4o。
  4. 部署該模型。
  5. 記錄端點、部署名稱、模型名稱、API 金鑰與 API 版本。

Note

Azure OpenAI 的 API 版本與 Azure AI Foundry 顯示的模型版本是分開的。請為您的部署選擇受支援的 API 版本。

設定 Azure AI Vision

影像翻譯會先使用 Azure AI Vision 從來源影像中擷取文字，然後才進行翻譯。

在您的 Azure AI 專案中，尋找 Azure AI 服務的金鑰與端點。

尋找 Azure AI 服務資訊

記錄：

  • Azure AI 服務端點
  • Azure AI 服務 API 金鑰

環境變數

將憑證新增到您的 .env 檔案或 CI 機密中。

# Azure AI Vision，為影像翻譯所需
AZURE_AI_SERVICE_API_KEY="..."
AZURE_AI_SERVICE_ENDPOINT="https://<resource>.cognitiveservices.azure.com/"

# Azure OpenAI，為文字翻譯所需
AZURE_OPENAI_API_KEY="..."
AZURE_OPENAI_ENDPOINT="https://<resource>.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME="gpt-4o"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME="<deployment>"
AZURE_OPENAI_API_VERSION="2024-12-01-preview"

Co-op Translator 也支援可選的備援憑證組。複製整套提供者變數並加上後綴（例如 _1 或 _2）；備援組中的所有變數都必須使用相同的後綴。

AZURE_OPENAI_API_KEY_1="..."
AZURE_OPENAI_ENDPOINT_1="https://<resource-1>.openai.azure.com/"
AZURE_OPENAI_MODEL_NAME_1="gpt-4o"
AZURE_OPENAI_CHAT_DEPLOYMENT_NAME_1="<deployment-1>"
AZURE_OPENAI_API_VERSION_1="2024-12-01-preview"

下一步