API 文档

轻湖语音转文字服务接口说明

音频转写接口

POST /api/v1/asr

上传音频文件，返回转写文本。Content-Type: multipart/form-data

请求参数
参数类型必填说明
filefile是音频文件（wav/mp3/flac/m4a/ogg/aac/wma）
backendstring否funasr | whispercpp | auto（默认 auto）
languagestring否zh | en | auto（默认 auto）
响应示例
{
  "code": 200,
  "data": {
    "backend": "funasr",
    "text": "欢迎大家来体验达摩院推出的语音识别模型",
    "segments": [
      { "start": 0, "end": 3200, "text": "欢迎大家来体验达摩院推出的语音识别模型" }
    ],
    "language": "zh",
    "elapsed_ms": 1234
  }
}
curl 示例
curl -X POST http://localhost:36098/api/v1/asr \
  -F "file=@test.wav" \
  -F "backend=funasr" \
  -F "language=zh"
后端状态查询

GET /api/v1/asr/backends

查询可用 ASR 后端及健康状态

响应示例
{
  "code": 200,
  "data": {
    "default_backend": "funasr",
    "backends": [
      { "name": "funasr", "available": true },
      { "name": "whispercpp", "available": true }
    ]
  }
}
curl 示例
curl http://localhost:36098/api/v1/asr/backends
支持的音频格式
WAV MP3 FLAC M4A OGG AAC WMA

文件大小限制：50MB