mingyan

SoundClone - 提交试听任务

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

POST/kyyReactApiServer/v1/soundCloning/clones

SoundClone 提交试听任务

提交声音克隆试听任务。接口接收原音频或原视频地址，任务完成后可通过查询接口获取试听音频地址和 modelId。后续提交音频生成任务时，需要使用该 modelId。

认证

获取 Key

所有请求都需要在请求头中包含 Bearer token：

cURL

Authorization: Bearer {{key}}

基础 URL

https://zcbservice.aizfw.cn/kyyReactApiServer

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

请求参数

fileUrlbodystring必填

克隆声音的原音频或原视频地址。资源链接需要使用网络资源，不能使用本地资源，资源链接不要带中文。

音频格式支持：mp3、ogg、wav、m4a、aac。

视频格式支持：mp4、avi、mov、mkv、flv。

音视频中实际说话时长须大于 15 秒且小于 60 秒。

contentTextbodystring

可指定生成试听音频的内容文本，内容小于 270 个字。

不传时默认使用：

在森林的深处，阳光透过树梢洒落，鸟儿的歌声交织成一曲美妙的乐章，诉说着大自然无尽的美丽。

soundVersionbodystring

声音模型版本。

v1：模型 1，支持 24 种语言
v2：模型 2，支持 40 种语言

不传时默认使用 v1。具体语言范围请参考 language 字段。

languagebodystring

语言类型，不传时默认使用 auto。

v1 和 v2 均支持：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（印地语）。

以下语言需要 soundVersion 传 v2：Bulgarian（保加利亚语）、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

错误信息，失败时返回。