转写

POST /v1/audio/transcriptions 把一段短音频转成文字——例如用户录的语音备忘，转成文字后作为消息发送。

curl -s "$NEWEYES_API_BASE/v1/audio/transcriptions" -X POST \
  -H "Authorization: Bearer $NEWEYES_USER_TOKEN" \
  -F "file=@voice-note.m4a" \
  -F "language=en"

{ "object": "transcription", "text": "Remind me what we decided about the kitchen tiles." }

• file：音频，以 multipart/form-data 发送：最大 25 MB 的音频文件。
• language：可选，所说语言的代码，例如 en。en-US 这样的地区标签按其语言处理。不填或填 auto，则从音频中自动判断语言。
• 转写需要项目的计费账户有可用余额。

状态码	错误码	含义
413	file_too_large	音频超过 25 MB。
422	unsupported_media_type、validation_failed	不是音频；音频为空或无法读取；或语言不是有效的语言代码。
502	upstream_error	这段音频无法转写。请重试，或换一段录音。
503	service_unavailable	转写暂时不可用。请稍后重试。

如果是实时的语音对话，请改用实时语音：它会在双方说话时同步转写。