多人语音生成

请求参数

字段类型必填说明

model: string必填

模型 ID。推荐使用稳定 model ID；需要复现固定版本时，可填写 snapshot model ID。

async: boolean可选

设为 true 时创建异步任务并立即返回任务对象；任务结果通过查询任务获取，webhook_url 仅用于接收终态通知。

webhook_url: string可选

异步任务完成后回调的 HTTPS URL。

speakers: array必填

说话人配置数组，声明每个说话人及其音色，不能为空。

speakers[].id: string必填

说话人标识，供 segments[].speaker 引用。

speakers[].voice_id: string必填

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

segments: array必填

分句数组，按说话人给出台词，不能为空。

segments[].speaker: string必填

说话人标识，必须匹配 speakers[].id 之一。

segments[].text: string必填

该句台词文本。

response_format: string可选

同步请求的音频格式；异步任务不保证按该字段指定格式输出，实际格式以任务查询返回为准。

delivery_method: string可选

结果交付方式。

aigc_metadata: object可选

控制是否在生成的音频文件中写入 AIGC 隐式标识，默认不写入。该字段仅影响最终音频文件的元数据，不影响语音合成内容。

aigc_metadata.enabled: boolean可选

是否写入 AIGC 隐式标识，默认 false。

aigc_metadata.content_propagator: string可选

内容传播服务提供者的名称或编码。

aigc_metadata.propagate_id: string可选

内容传播编号，用于标识本次内容传播。

返回值

传入 async=true 时，接口立即返回异步任务对象；使用返回的 task_id，随后调用 GET /v1/audio/tasks/{task_id} 查询结果。

未启用异步时，delivery_method=url 返回包含音频地址的 JSON；delivery_method=audio 或不传时直接返回音频二进制，具体格式以响应头 Content-Type 为准。

错误码

HTTP	error.code	触发条件	处理建议
404	`voice_not_found`	某个 `speakers[].voice_id` 不存在或不可用	逐个确认 `speakers[].voice_id` 是否可用。

下一步

查询音色列表

查询当前账号可用音色列表。

单人语音生成

文本转语音接口。

请求示例

curl -X POST "https://api.mosi.cn/v1/audio/speech/speakers" \
  -H "Authorization: Bearer $MOSS_API_KEY" \
  -H "Platform: moss-platform" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "moss-ttsd-1.0",
  "speakers": [
    {
      "id": "speaker_a",
      "voice_id": "7e5020e3-b88e-4271-a996-2908a182dd32"
    },
    {
      "id": "speaker_b",
      "voice_id": "2925f9ce-75af-4354-8757-b52c3e541e8c"
    }
  ],
  "segments": [
    {
      "speaker": "speaker_a",
      "text": "诶，我最近看了一篇讲人工智能的文章，还挺有意思的，想跟你聊聊。"
    },
    {
      "speaker": "speaker_b",
      "text": "哦？是吗，关于啥的啊？又是哪个公司发了什么逆天的新模型吗？"
    }
  ],
  "response_format": "mp3",
  "delivery_method": "url"
}'

import os
import requests

response = requests.post(
        "https://api.mosi.cn/v1/audio/speech/speakers",
        headers={
        "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
        "Platform": "moss-platform",
        "Content-Type": "application/json",
        },
        json={
            "model": "moss-ttsd-1.0",
            "speakers": [
                {
                    "id": "speaker_a",
                    "voice_id": "7e5020e3-b88e-4271-a996-2908a182dd32",
                },
                {
                    "id": "speaker_b",
                    "voice_id": "2925f9ce-75af-4354-8757-b52c3e541e8c",
                },
            ],
            "segments": [
                {
                    "speaker": "speaker_a",
                    "text": "诶，我最近看了一篇讲人工智能的文章，还挺有意思的，想跟你聊聊。",
                },
                {
                    "speaker": "speaker_b",
                    "text": "哦？是吗，关于啥的啊？又是哪个公司发了什么逆天的新模型吗？",
                },
            ],
            "response_format": "mp3",
            "delivery_method": "url",
        },
)

response.raise_for_status()
print(response.json())

const response = await fetch("https://api.mosi.cn/v1/audio/speech/speakers", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.MOSS_API_KEY,
    "Platform": "moss-platform",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "model": "moss-ttsd-1.0",
    "speakers": [
      {
        "id": "speaker_a",
        "voice_id": "7e5020e3-b88e-4271-a996-2908a182dd32"
      },
      {
        "id": "speaker_b",
        "voice_id": "2925f9ce-75af-4354-8757-b52c3e541e8c"
      }
    ],
    "segments": [
      {
        "speaker": "speaker_a",
        "text": "诶，我最近看了一篇讲人工智能的文章，还挺有意思的，想跟你聊聊。"
      },
      {
        "speaker": "speaker_b",
        "text": "哦？是吗，关于啥的啊？又是哪个公司发了什么逆天的新模型吗？"
      }
    ],
    "response_format": "mp3",
    "delivery_method": "url"
  }),
})

if (!response.ok) throw new Error(`HTTP ${response.status}`)
console.log(await response.json())

响应示例

{
  "id": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "object": "audio.speech",
  "status": "SUCCESS",
  "url": "https://cdn.example.com/out.mp3",
  "response_format": "mp3",
  "content_type": "audio/mpeg",
  "created_at": 1710000000
}