mingyanmingyan
mingyan

SoundClone - 提交试听任务

提交声音克隆试听任务,生成试听音频并返回声音模型 ID

POST/kyyReactApiServer/v1/soundCloning/clones

SoundClone 提交试听任务

提交声音克隆试听任务。接口接收原音频或原视频地址,任务完成后可通过查询接口获取试听音频地址和 modelId。后续提交音频生成任务时,需要使用该 modelId
所有请求都需要在请求头中包含 Bearer token:
cURL
Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl 为所有对外 API 的公共前缀。当前页面 frontmatter 中的 api 字段展示的是完整请求地址,请在接入时以这里的 baseUrl 为统一前缀理解和拼接接口路径。

请求参数

fileUrlbodystring必填
克隆声音的原音频或原视频地址。资源链接需要使用网络资源,不能使用本地资源,资源链接不要带中文。
音频格式支持:mp3oggwavm4aaac
视频格式支持:mp4avimovmkvflv
音视频中实际说话时长须大于 15 秒且小于 60 秒。
contentTextbodystring
可指定生成试听音频的内容文本,内容小于 270 个字。
不传时默认使用:在森林的深处,阳光透过树梢洒落,鸟儿的歌声交织成一曲美妙的乐章,诉说着大自然无尽的美丽。
soundVersionbodystring
声音模型版本。
  • v1:模型 1,支持 24 种语言
  • v2:模型 2,支持 40 种语言
不传时默认使用 v1。具体语言范围请参考 language 字段。
languagebodystring
语言类型,不传时默认使用 auto
v1v2 均支持:Chinese(中文)、Chinese,Yue(粤语)、English(英语)、Arabic(阿拉伯语)、Russian(俄语)、Spanish(西班牙语)、French(法语)、Portuguese(葡萄牙语)、German(德语)、Turkish(土耳其语)、Dutch(荷兰语)、Ukrainian(乌克兰语)、Vietnamese(越南语)、Indonesian(印尼语)、Japanese(日语)、Italian(意大利语)、Korean(韩语)、Thai(泰语)、Polish(波兰语)、Romanian(罗马尼亚语)、Greek(希腊语)、Czech(捷克语)、Finnish(芬兰语)、Hindi(印地语)。
以下语言需要 soundVersionv2Bulgarian(保加利亚语)、Danish(丹麦语)、Hebrew(希伯来语)、Malay(马来语)、Persian(波斯语)、Slovak(斯洛伐克语)、Swedish(瑞典语)、Croatian(克罗地亚语)、Filipino(菲律宾语)、Hungarian(匈牙利语)、Norwegian(挪威语)、Slovenian(斯洛文尼亚语)、Catalan(加泰罗尼亚语)、Nynorsk(尼诺斯克语)、Tamil(泰米尔语)、Afrikaans(阿非利卡语)、auto(自动检测)。
示例:Chinese

响应参数

idstring
任务 ID,用于后续查询任务状态。
objectstring
对象类型,固定为 audio
createdinteger
任务创建时间戳。
modelstring
使用的模型名称,试听任务为 soundCloningClone
statusstring
任务状态,创建后通常为 queued
errorstring
错误信息,失败时返回。