Transcrição de Áudio com Azure AI Speech para Python

Quando Usar

• Transcreva um arquivo de áudio autorizado com o cliente azure-ai-transcription.
• Revise a saída com carimbos de data/hora e as opções suportadas pela versão do SDK instalada.
• Para trabalhos de streaming ou em lote assíncronos, selecione a API de Fala apropriada em vez disso.

Pré-requisitos

Use um SDK fixado ao projeto em um ambiente Python isolado. Confirme o recurso de Fala, o endpoint, as permissões, o consentimento do áudio, o custo e a retenção antes do upload. Não registre chaves, conteúdos de áudio ou transcrições completas por padrão.

Exemplo de Arquivo

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.

Autenticação e Limite da API

DefaultAzureCredential também é suportado quando a identidade tem a função de recurso necessária. Os exemplos anteriores begin_transcription e begin_stream_transcription não corresponderam a este cliente. Não invente um adaptador de streaming.

Exemplo de Solicitação

“Transcreva esta gravação local consentida; mantenha a transcrição privada.”

Limitações

Verifique as assinaturas instaladas e os limites do serviço em relação ao guia de SDK da Microsoft. Esta ilustração não contatou o Azure; a disponibilidade, precisão e custos exigem verificação no ambiente autorizado.