azure-ai-transcription-py

Azure AI Speech 的 Python 转录

适用场景

• 使用 azure-ai-transcription 客户端转录已获授权的音频文件。
• 查看时间戳输出，以及已安装的 SDK 版本支持的选项。
• 对于流式或异步批处理作业，请选择合适的 Speech API。

先决条件

在隔离的 Python 环境中使用固定到项目的 SDK。上传前，请确认 Speech 资源、终结点、权限、音频使用许可、费用和保留期限。 默认情况下，不要记录密钥、音频内容或完整转录文本。

文件示例

import os
from azure.core.credentials import AzureKeyCredential
from azure.ai.transcription import TranscriptionClient
from azure.ai.transcription.models import TranscriptionContent, TranscriptionOptions

client = TranscriptionClient(
    endpoint=os.environ["TRANSCRIPTION_ENDPOINT"],
    credential=AzureKeyCredential(os.environ["TRANSCRIPTION_KEY"]),
)
with client:
    with open("audio.wav", "rb") as audio:
        result = client.transcribe(TranscriptionContent(
            definition=TranscriptionOptions(locales=["en-US"]), audio=audio,
        ))
# Inspect result locally; handle empty output and service errors explicitly.

身份验证与 API 边界

如果身份具有所需的资源角色，也支持 DefaultAzureCredential。之前的 begin_transcription 和 begin_stream_transcription 示例与此客户端不匹配。 不要臆造流式适配器。

请求示例

“转录这段已获许可的本地录音；请对转录文本保密。”

限制

请根据 Microsoft 的 SDK 指南 验证已安装版本的签名和服务限制。 此示例未连接 Azure；可用性、准确性和费用需在获授权的环境中验证。