使用Azure OpenAI SDK结合Whisper实现语音转文本时遇404错误排查

我使用以下包引用：

<PackageReference Include="Azure.AI.OpenAI" Version="2.0.0-beta.2" />

编写了如下简单代码：

var client = new OpenAIClient(
    new ApiKeyCredential(apiKey),
    new OpenAIClientOptions { Endpoint = new Uri(apiEndPoint) }
    );

var transcriptionOptions = new AudioTranscriptionOptions() { ResponseFormat = AudioTranscriptionFormat.Simple };

var audioClient = client.GetAudioClient(deploymentId);
var bytes = File.ReadAllBytes(filePath);
var stream = new MemoryStream(bytes);

var result = await audioClient.TranscribeAudioAsync(stream, fileName, transcriptionOptions);

运行时出现404错误。我的端点（Endpoint）和API密钥（API key）直接取自Playground快速启动窗口，理论上是正确的：

请问我遗漏了什么配置或步骤？

• 检查部署ID正确性：确保deploymentId是Azure OpenAI资源中**音频转写模型（如Whisper）**的部署名称，而非GPT系列模型的ID。部署ID拼写错误或模型类型不匹配，会直接导致404。
• 验证端点格式：Azure OpenAI的标准端点格式为https://{resource-name}.openai.azure.com/，需确认从Playground复制的端点是否附带多余后缀（比如/openai/），如有则需删除，仅保留到域名部分。
• 确认模型部署状态：检查Azure OpenAI资源中的音频转写模型是否已完成部署，且状态为正常运行。若模型部署未完成，或资源区域与请求区域不匹配，也会触发404。
• 检查包版本兼容性：你使用的是预览版包2.0.0-beta.2，可能存在API端点路径的变更。建议升级到最新稳定版（如1.0.0及以上），或对照官方文档确认预览版的端点使用规则。
• 验证音频文件格式：确保上传的音频文件符合模型支持的格式（如mp3、wav等），格式不兼容也可能导致服务端返回404或其他错误。

内容的提问来源于stack exchange，提问作者Sean