API 指南 / Trellis 语音识别(SenseVoice)
API 指南 · Trellis 语音识别(SenseVoice)
语音转文字(ASR),支持中文 / 粤语 / 英语 / 日语 / 韩语,默认输出纯文本。
调用方式
同步:直接 POST 返回结果(建议超时 300s);超时后请勿自动重试。
异步(推荐):POST 加请求头
X-Trellis-Async: 1 → 返回 202 {id, poll};轮询 GET /v1/jobs/{id}(间隔 5–10s)。以 multipart/form-data 上传音频文件字段 file,可选 language 指定语言(默认 auto 自动识别)。
返回 text 为转写文本,usage.seconds 为音频时长(按秒计费)。
支持 wav / mp3 等常见格式;默认去除情感标签,只返回纯文本。
调用示例:
cURL
curl https://api.trellis.hk/v1/audio/transcriptions \
-H "Authorization: Bearer sk-xxxxxxxx" \
-F file=@a.wav \
-F language=zhPython
from openai import OpenAI
client = OpenAI(api_key="sk-xxxxxxxx", base_url="https://api.trellis.hk/v1")
with open("a.wav", "rb") as f:
r = client.audio.transcriptions.create(
model="trellis-sensevoice", file=f, language="zh"
)
print(r.text)所有模型共用同一 API Key 与同一端点:
https://api.trellis.hk/v1