单人语音生成

将一段文本合成为单一音色的语音，适合旁白、客服话术、播报和有声内容生成。

1. 创建 API Key

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

   MOSS_API_KEY=<your_api_key_here>

2. 准备请求输入

   填入文本、音色和模型 moss-tts-1.5-flash；非流式直接生成音频或 URL，流式则传 stream=true。

   字段状态要求说明

   model: string必填

   moss-tts-1.5-flash

   input: string必填

   待合成文本

   voice_id: string必填

   音色 ID，可从查询音色列表或创建音色接口获得

   response_format: string可选

   同步请求的音频格式，例如 mp3 / wav，推荐 mp3

   delivery_method: string可选

   audio 直接返回音频；url 返回 JSON 和结果 URL

   stream: boolean可选

   设为 true 时启用流式返回

   非流式流式

   {
     "model": "moss-tts-1.5-flash",
     "input": "欢迎使用 Moss API。[pause 0.8s]现在开始生成语音。",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "response_format": "mp3",
     "delivery_method": "url"
   }

   {
     "model": "moss-tts-1.5-flash",
     "input": "欢迎使用 Moss API。",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "stream": true,
     "response_format": "pcm",
     "stream_format": "sse"
   }

   试听音色，复制对应 Voice ID 后填入请求。

   更多音色请到 Mossland 音色库查看。

3. 发起第一次请求

   向当前场景的 endpoint 发起请求。同步请求可能直接返回音频、URL 或文本；异步请求会返回任务对象。

   非流式SSE 流式

   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": "欢迎使用 Moss API。[pause 0.8s]现在开始生成语音。",
     "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": "欢迎使用 Moss API。[pause 0.8s]现在开始生成语音。",
           "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": "欢迎使用 Moss API。[pause 0.8s]现在开始生成语音。",
     "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": "欢迎使用 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": "欢迎使用 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": "欢迎使用 Moss API。",
     "voice_id": "94aa4989-c7e9-5007-ae42-ab401823e6c9",
     "stream": true,
     "response_format": "pcm",
     "stream_format": "sse"
   }),
   });
   
   const reader = response.body?.getReader();
   // 按服务端约定的分片协议消费流式数据

4. 获取任务结果

   使用 delivery_method=url 同步调用时，从响应 JSON 中读取结果 URL；使用 SSE 时读取至 speech.audio.done。传入 async=true 时会返回 task_id，可通过 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. 验证成功

   成功标志：拿到结果音频（delivery_method=audio）或结果 URL（delivery_method=url），可下载或播放生成音频。

下一步