你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

快速入门：通过 Azure OpenAI 服务进行文本转语音

  • 项目

在本快速入门中，你将使用 Azure OpenAI 服务通过 OpenAI 语音进行文本转语音。

可用语音为：alloy、echo、fable、onyx、nova 和 shimmer。 有关详细信息，请参阅文本转语音的 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。 始终准备好两个密钥可以安全地轮换和重新生成密钥，而不会导致服务中断。

Azure 门户中 Azure OpenAI 资源概述 UI 的屏幕截图，其中终结点和访问密钥位置突出显示。

为密钥和终结点创建和分配持久环境变量。

环境变量

setx AZURE_OPENAI_API_KEY "REPLACE_WITH_YOUR_KEY_VALUE_HERE" 

setx AZURE_OPENAI_ENDPOINT "REPLACE_WITH_YOUR_ENDPOINT_HERE"

REST API

在 bash shell 中运行以下命令： 需要将 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 资源，可以删除该资源。 在删除资源之前，必须先删除所有已部署的模型。

后续步骤