mingyanmingyan
wechatwechat
mingyan

SoundClone - Create Clone Preview Task

Submit a voice cloning preview task to generate a preview audio and model ID

POST/kyyReactApiServer/v1/soundCloning/clones

SoundClone Create Clone Preview Task

Submit a voice cloning preview task. The API accepts an original audio or video URL. After the task is completed, use the query API to get the preview audio URL and modelId. The modelId is required when creating a generated audio task.

认证

获取 Key
All requests must include a Bearer token in the request header:
cURL
Authorization: Bearer {{key}}

Base URL

https://zcbservice.aizfw.cn/kyyReactApiServer
baseUrl is the shared prefix for all public APIs. The api field in the current page frontmatter shows the full endpoint. Use this baseUrl as the common prefix when reading or composing request paths.

Request Parameters

fileUrlbodystringrequired
Original audio or video URL for voice cloning. The resource must be a network URL, not a local file path. Do not include Chinese characters in the URL.
Supported audio formats: mp3, ogg, wav, m4a, aac.
Supported video formats: mp4, avi, mov, mkv, flv.
The actual speaking duration in the media must be longer than 15 seconds and shorter than 60 seconds.
contentTextbodystring
Text used to generate the preview audio. The content must be shorter than 270 Chinese characters.
If omitted, the default text is: 在森林的深处，阳光透过树梢洒落，鸟儿的歌声交织成一曲美妙的乐章，诉说着大自然无尽的美丽。
soundVersionbodystring
Voice model version.
  • v1: Model 1, supports 24 languages
  • v2: Model 2, supports 40 languages
Defaults to v1 when omitted. See the language field for supported languages.
languagebodystring
Language type. Defaults to auto when omitted.
Supported by both v1 and 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.
The following languages require soundVersion to be v2: Bulgarian, Danish, Hebrew, Malay, Persian, Slovak, Swedish, Croatian, Filipino, Hungarian, Norwegian, Slovenian, Catalan, Nynorsk, Tamil, Afrikaans, auto.
Example: Chinese.

Response Parameters

idstring
Task ID, used to query the task status later.
objectstring
Object type, fixed as audio.
createdinteger
Task creation timestamp.
modelstring
Model name used by the task. For preview tasks, it is soundCloningClone.
statusstring
Task status. It is usually queued after creation.
errorstring
Error message, returned when the task fails.