API 文档

提交音频或文字后,接口会返回任务编号。使用同一把密钥查询结果。

连接服务

以下示例使用 Bash、curl 和 jq。请从管理员处获取访问密钥,在终端按提示输入。

BASE='https://voice.tingease.com'
read -rsp '输入 API Key: ' TINGEASE_KEY; echo
AUTH="Authorization: Bearer $TINGEASE_KEY"
curl -fsS -H "$AUTH" "$BASE/api/me"

语音转写

POST /api/asr 接收音频文件的二进制内容。每个文件最多 12 MiB、最长 3 分钟。以下示例上传当前目录的 WAV 录音并保存任务编号。

JOB=$(curl -fsS -H "$AUTH" -H 'Content-Type: audio/wav' \
  --data-binary @recording.wav "$BASE/api/asr" | jq -er '.data.id')

文字朗读

POST /api/tts 接收最多 500 字的文字,完成后提供 WAV 音频。

JOB=$(curl -fsS -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"text":"你好,欢迎使用听易。"}' "$BASE/api/tts" | jq -er '.data.id')

文本助手

POST /api/text 接收指令和原文,合计最多 1,000 字。首次加载模型可能需要等待。

JOB=$(curl -fsS -H "$AUTH" -H 'Content-Type: application/json' \
  -d '{"text":"用一句话概括:周三下午三点开会,讨论新版本。"}' \
  "$BASE/api/text" | jq -er '.data.id')

取回结果

提交成功返回 HTTP 202 和 data.id。每隔两秒查询一次任务,状态从 queued、running 变为 done 或 failed。转写和文本结果位于 data.text。

while RESULT=$(curl -fsS -H "$AUTH" "$BASE/api/jobs/$JOB"); do
  case "$(jq -r '.data.status' <<< "$RESULT")" in
    done) jq -r '.data.text // .data.audio_url' <<< "$RESULT"; break ;;
    failed) jq -r '.data.error' <<< "$RESULT" >&2; break ;;
  esac
  sleep 2
done

朗读任务完成后,携带密钥下载音频。结果保留约 10 分钟。

AUDIO=$(jq -er '.data.audio_url' <<< "$RESULT")
curl -fsS -H "$AUTH" "$BASE$AUDIO" -o speech.wav

接口错误会返回非成功状态码。读取响应中的 msg 查看原因。密钥失效或任务过期时,请分别检查密钥或重新提交输入。