向OpenAI Whisper模型发送音频文件遇file字段缺失错误求助

算力阿峰

2026-7-26

解决OpenAI Whisper转录API的"file字段缺失"错误

你遇到的问题核心是请求格式不符合API要求：Whisper的转录API需要用multipart/form-data格式上传音频文件，且必须指定file字段，而不是用JSON传递base64编码的音频内容。

修正步骤：

无需将Blob转成base64，直接用FormData包装音频文件和模型参数
移除手动设置的Content-Type: application/json，浏览器会自动生成正确的multipart请求头
把音频Blob放到file字段，模型名称放到model字段

修正后的代码：

const handleUpload = () => {
  const audioBlob = new Blob(audioChunks, { type: "audio/webm" });

  // 创建FormData对象，按API要求组织参数
  const formData = new FormData();
  // 第一个参数是API要求的"file"，第二个是Blob，第三个是自定义文件名
  formData.append("file", audioBlob, "recording.webm");
  formData.append("model", "whisper-1");

  fetch("https://api.openai.com/v1/audio/transcriptions", {
    method: "POST",
    headers: {
      Authorization: `Bearer ${key}`,
      // 不要手动设置Content-Type，浏览器会自动处理multipart/form-data的边界
    },
    body: formData,
  })
    .then((response) => response.json())
    .then((data) => console.log(data))
    .catch((error) => console.error(error));
};