快速开始：文件转录

这份指南帮助你上传一段录音，并从响应中读取转录文字。

准备

准备有效的企业 ASR API Key 和音频文件 sample.wav。以下示例在 Bash、zsh 等终端运行；Windows 可使用 WSL 或 Git Bash。

发送第一次请求

将 YOUR_API_KEY 换成自己的 Key，将 sample.wav 换成实际文件路径。

使用 --form 上传文件，cURL 会自动生成正确的 multipart/form-data 请求头及 boundary，无需手动填写 Content-Type。

读取转录结果

请求成功时返回 HTTP 200。响应示例：

{
  "language": "en",
  "confidence_score": 0.98,
  "text": "Hello.",
  "words": [
    {
      "text": "Hello.",
      "start_time": 0.0,
      "end_time": 0.5,
      "confidence_score": 0.98,
      "token_type": "word"
    }
  ]
}

完整文字读取 text；需要逐词信息时再处理 words。响应字段可能随模型与选项变化，详细说明见创建文件转录。

转录医疗录音

使用相同请求，将模型字段替换为：

model_id=echo_v2_medical

医疗模型使用 HTTP 文件转录，不支持实时 WebSocket。模型选择及高级功能适用范围见模型与能力。

遇到错误

现象	先检查什么
HTTP 401	Key 是否有效，是否放在 `API-Key` 请求头中
`missing_input`	是否真正上传了文件；本地路径是否存在
`invalid model_id`	模型 ID 的拼写与所用接口是否匹配
HTTP 200，但 `text` 为空	音频是否包含可识别的语音，是否主要为静音

下一步

选择模型和功能。

查看全部文件转录参数，按需添加时间戳、说话人或识别增强设置。

查询本次日期范围的用量。

准备#

发送第一次请求#

读取转录结果#

转录医疗录音#

遇到错误#

下一步#

准备

发送第一次请求

读取转录结果

转录医疗录音

遇到错误

下一步