快速入門:使用 Azure OpenAI 服務進行文字到語音轉換
在本快速入門中,您會使用 Azure OpenAI 服務搭配 OpenAI 語音進行文字轉換。
可用的語音包括:alloy
、、echo
fable
、onyx
、nova
、 和 shimmer
。 如需詳細資訊,請參閱 適用於文字到語音轉換的 Azure OpenAI 服務參考檔。
必要條件
- Azure 訂用帳戶 - 免費建立一個訂用帳戶。
- 在所需的 Azure 訂用帳戶中授與 Azure OpenAI Service 的存取權。
- 在已部署 或
tts-1-hd
模型的美國中北部或瑞典中部區域中建立的tts-1
Azure OpenAI 資源。 如需詳細資訊,請參閱使用 Azure OpenAI 建立資源及部署模型。
注意
目前,您必須提交應用程式以存取 Azure OpenAI 服務。 若要申請存取權限,請填寫此表單。
設定
擷取金鑰和端點
若要成功對 Azure OpenAI 進行呼叫,您需要 端點 和 密鑰。
變數名稱 | 值 |
---|---|
AZURE_OPENAI_ENDPOINT |
從 Azure 入口網站查看您的資源時,可以在 [金鑰與端點] 區段中找到此值。 或者,您可以在 Azure OpenAI Studio遊樂場>程式代碼檢視中找到值。> 範例端點為:https://aoai-docs.openai.azure.com/ 。 |
AZURE_OPENAI_API_KEY |
從 Azure 入口網站查看您的資源時,可以在 [金鑰與端點] 區段中找到此值。 您可以使用 KEY1 或 KEY2 。 |
移至您在 Azure 入口網站中的資源。 您可以在 [資源管理] 區段中找到 [端點和金鑰]。 複製您的端點和存取金鑰,因為您需要這兩者才能驗證 API 呼叫。 您可以使用 KEY1
或 KEY2
。 隨時持有兩個金鑰可讓您安全地輪替和重新產生金鑰,而不會造成服務中斷。
為您的金鑰和端點建立及指派永續性環境變數。
環境變數
setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE"
setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"
REST API
在bash殼層中,執行下列命令。 您必須將 取代 YourDeploymentName
為您在將文字部署至語音模型時所選擇的部署名稱。 部署名稱不一定與模型名稱相同。 除非您選擇與基礎模型名稱相同的部署名稱,否則輸入模型名稱會導致錯誤。
curl $AZURE_OPENAI_ENDPOINT/openai/deployments/YourDeploymentName/audio/speech?api-version=2024-02-15-preview \
-H "api-key: $AZURE_OPENAI_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "tts-1-hd",
"input": "I'm excited to try text to speech.",
"voice": "alloy"
}' --output speech.mp3
使用範例端點的命令第一行格式會顯示如下 curl https://aoai-docs.openai.azure.com/openai/deployments/{YourDeploymentName}/audio/speech?api-version=2024-02-15-preview \
。
重要
在生產環境中,請使用安全的方式來儲存和存取您的認證,例如 Azure Key Vault。 如需有關認證安全性的詳細資訊,請參閱 Azure AI 服務安全性一文。
清除資源
如果您想要清除並移除 Azure OpenAI 資源,您可以刪除資源。 刪除資源之前,您必須先刪除任何已部署的模型。
下一步
- 在 Azure OpenAI 服務參考檔中,深入瞭解如何使用文字到語音轉換與 Azure OpenAI 服務。
- 如需更多範例,請參閱 Azure OpenAI 範例 GitHub 存放庫