克隆音色

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

1. 创建 API Key

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

   MOSS_API_KEY=<your_api_key_here>

2. 准备请求输入

   准备一段本地参考音频，并根据需要填写音色名称和描述。

   字段类型要求说明

   audio_sample: file必填

   用于克隆音色的本地参考音频文件。

   name: string可选

   音色名称。

   description: string可选

   音色描述。

   该请求以 multipart/form-data 上传，没有 JSON 请求体；完整调用命令见下一步。

3. 发起创建请求

   向 POST /v1/audio/voices 发起请求。创建成功后，接口返回音色对象。

   curl -X POST "https://api.mosi.cn/v1/audio/voices" \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -F "audio_sample=@/path/to/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("/path/to/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

   创建成功后，响应中的 id 即为后续语音生成可使用的 voice_id。

   {
     "id": "<voice_id>",
     "object": "audio.voice",
     "created_at": 1710000000,
     "name": "customer-service-voice"
   }

5. 验证成功

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

下一步