Single-Speaker Speech Generation

Synthesize a piece of text into speech with a single voice, suited to narration, customer-service scripts, announcements, and audio content generation.

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.

   MOSS_API_KEY=<your_api_key_here>

2. Prepare the request input

   Provide the text, voice, and moss-tts-1.5-flash model. Non-streaming requests return audio or a URL; pass stream=true to enable streaming.

   FieldTypeRequirementDescription

   model: stringRequired

   moss-tts-1.5-flash

   input: stringRequired

   Text to synthesize

   voice_id: stringRequired

   Voice ID obtained from the list-voices or create-voice endpoint

   response_format: stringOptional

   Audio format for synchronous requests, such as mp3 or wav; mp3 is recommended

   delivery_method: stringOptional

   audio returns audio directly; url returns JSON with a result URL

   stream: booleanOptional

   Set to true to enable streaming

   Non-streamingStreaming

   {
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.[pause 0.8s]Now generating speech.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "response_format": "mp3",
     "delivery_method": "url"
   }

   {
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "stream": true,
     "response_format": "pcm",
     "stream_format": "sse"
   }

   Preview a voice and copy its Voice ID into your request.

   Browse more voices in the Mossland voice library.

3. Send the first request

   Send a request to the scenario endpoint. A synchronous request can return audio, a URL, or text directly; an asynchronous request returns a task object.

   Non-streamingSSE streaming

   curl -X POST "https://api.mosi.cn/v1/audio/speech" \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.[pause 0.8s]Now generating speech.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "response_format": "mp3",
     "delivery_method": "url"
   }'

   import os
   import requests
   
   resp = requests.post(
       "https://api.mosi.cn/v1/audio/speech",
       headers={
           "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
           "Content-Type": "application/json",
       },
       json={
           "model": "moss-tts-1.5-flash",
           "input": "Welcome to the Moss API.[pause 0.8s]Now generating speech.",
           "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
           "response_format": "mp3",
           "delivery_method": "url"
       },
   )
   
   print(resp.status_code)
   print(resp.json())

   const response = await fetch("https://api.mosi.cn/v1/audio/speech", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.MOSS_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.[pause 0.8s]Now generating speech.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "response_format": "mp3",
     "delivery_method": "url"
   }),
   });
   
   console.log(response.status);
   console.log(await response.json());

   curl -N -X POST "https://api.mosi.cn/v1/audio/speech" \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -H "Accept: text/event-stream" \
     -H "Content-Type: application/json" \
     -d '{
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "stream": true,
     "response_format": "pcm",
     "stream_format": "sse"
   }'

   import os
   import requests
   
   with requests.post(
       "https://api.mosi.cn/v1/audio/speech",
       headers={
           "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
           "Accept": "text/event-stream",
           "Content-Type": "application/json",
       },
       json={
           "model": "moss-tts-1.5-flash",
           "input": "Welcome to the Moss API.",
           "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
           "stream": True,
           "response_format": "pcm",
           "stream_format": "sse"
       },
       stream=True,
   ) as resp:
       resp.raise_for_status()
       for chunk in resp.iter_content(chunk_size=None):
           if chunk:
               print(chunk)

   const response = await fetch("https://api.mosi.cn/v1/audio/speech", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.MOSS_API_KEY}`,
       Accept: "text/event-stream",
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
     "model": "moss-tts-1.5-flash",
     "input": "Welcome to the Moss API.",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "stream": true,
     "response_format": "pcm",
     "stream_format": "sse"
   }),
   });
   
   const reader = response.body?.getReader();
   // Consume streaming chunks according to the server-defined protocol

4. Retrieve the task result

   For synchronous calls with delivery_method=url, read the result URL from the response JSON; when using SSE, read through the speech.audio.done event. Passing async=true returns a task_id; query the task result via GET /v1/audio/tasks/{task_id}.

   curl https://api.mosi.cn/v1/audio/tasks/$TASK_ID \
     -H "Authorization: Bearer $MOSS_API_KEY"

   resp = requests.get(
       f"https://api.mosi.cn/v1/audio/tasks/{task_id}",
       headers={"Authorization": f"Bearer {os.environ['MOSS_API_KEY']}"},
   )
   print(resp.json())

   const resp = await fetch(`https://api.mosi.cn/v1/audio/tasks/${taskId}`, {
     headers: { Authorization: `Bearer ${apiKey}` },
   })

5. Verify success

   Success indicator: you obtain the result audio (delivery_method=audio) or a result URL (delivery_method=url), and can download or play the generated audio.

Next steps