克隆音色

上传一段参考音频文件，创建可复用的 voice_id，供后续 TTS 或 TTSD 生成语音时使用。

操作流程

1. 创建 API Key

   进入 API Key 管理平台，创建 API Key，并保存为环境变量。不要把 API Key 写进客户端代码或提交到仓库。

   export MOSS_API_KEY="<your-api-key>"
   

2. 准备参考音频

   准备一段参考音频文件。创建音色仅支持 multipart/form-data，参考音频用 audio_sample 文件字段上传；不支持 JSON body、file_id 或 audio_url。

   audio_sample：参考音频文件（multipart） name：音色名称 description：音色描述

3. 创建音色

   用参考音频文件创建音色，可选传入 name、description。该接口仅支持 multipart/form-data。

   cURLPythonTypeScript

   curl https://api.mosi.cn/v1/audio/voices \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -F audio_sample=@sample.wav \
     -F name=customer-service-voice
   

   import os
   import requests
   
   resp = requests.post(
       "https://api.mosi.cn/v1/audio/voices",
       headers={"Authorization": f"Bearer {os.environ['MOSS_API_KEY']}"},
       files={"audio_sample": open("sample.wav", "rb")},
       data={"name": "customer-service-voice"},
   )
   print(resp.json())
   

   const form = new FormData()
   form.append('audio_sample', audioFile)
   form.append('name', 'customer-service-voice')
   const resp = await fetch('https://api.mosi.cn/v1/audio/voices', {
     method: 'POST',
     headers: { Authorization: `Bearer ${apiKey}` },
     body: form,
   })
   

4. 验证成功

   成功标志：响应中返回可复用的 voice_id，可在后续 TTS / TTSD 调用中通过 voice 或 voice_id 引用。

下一步