Clone a Voice

Upload a reference audio file to create a reusable voice_id for later use when generating speech with TTS or TTSD.

Workflow

1. Create an API Key

   Open the API Key management platform, create an API Key, and save it as an environment variable. Do not write the API Key into client-side code or commit it to a repository.

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

2. Prepare the reference audio

   Prepare a reference audio file. Voice creation supports only multipart/form-data; the reference audio is uploaded via the audio_sample file field. A JSON body, file_id, or audio_url is not supported.

   audio_sample: reference audio file (multipart) name: voice name description: voice description

3. Create the voice

   Create a voice from the reference audio file, optionally passing name and description. This endpoint supports only 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. Verify success

   Success indicator: the response returns a reusable voice_id, which you can reference via voice or voice_id in subsequent TTS / TTSD calls.

Next steps