API 文档 / Trellis 语音合成（CosyVoice3）
API 文档 · Trellis 语音合成（CosyVoice3）
模型 ID：trellis-cosyvoice3
接口
POST /v1/audio/voicesmultipart/form-data注册（克隆）音色GET /v1/audio/voices列出已注册音色POST /v1/audio/speechapplication/json合成语音POST /v1/jobs/{id}/cancel取消任务（canceling → canceled；不计费）调用方式
同步：直接 POST 返回结果（建议超时 600s）；超时后请勿自动重试。
异步（推荐）：POST 加请求头
X-Trellis-Async: 1 → 返回 202 {id, poll}；轮询 GET /v1/jobs/{id}（间隔 5–10s）。请求参数：
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
model | string | 是 | trellis-cosyvoice3 | 固定 trellis-cosyvoice3 |
file | file | 是 | — | （注册音色）参考音频 wav/mp3 |
prompt_text | string | 是 | — | （注册音色）参考音频对应文本 |
name | string | 否 | — | （注册音色）音色名，缺省随机 id |
input | string | 是 | — | （合成）待合成文本 |
voice | string | 是 | — | （合成）预置或已注册的 voice_id |
instruction | string | 否 | — | （合成）情感/语气（扩展） |
speed | number | 否 | 1.0 | （合成）语速 |
response_format | string | 否 | wav | （合成）当前仅 wav |
qc | boolean | 否 | false | （合成）是否同步质检（不额外收费，耗时更长：≥5 分钟） |
预置音色
平台已预置以下音色，合成时直接用 voice=<id> 即可，无需上传；GET /v1/audio/voices 可获取全部音色。
yunshang高冷贵气 · 30 女
qinghe自然亲切 · 30 女
tianxin可爱甜美 · 25 女
xiaole亲切活泼 · 22 女
nuanxi温柔知性 · 25 女
coco成熟知性 · 28 女
lulu青春甜美 · 20 女
wenjing温婉 · 45 女
nainai慈祥奶奶 · 70 女
xiaotang童声 · 5 女
yangyang阳光青年 · 25 男
bruce英文腔 · 28 男
laochuan川味大叔 · 40 男
laobo沧桑老人 · 65 男
xiaohuo顽皮少年 · 8 男
xiaodou童声 · 5 男
响应示例：
HTTP 200 Content-Type: audio/wav
响应头: X-Usage-Characters: 10
(响应体为 wav 音频字节)所有模型共用同一 API Key 与同一端点：
https://api.trellis.hk/v1