音色设计

根据待合成文本和声音风格描述，生成对应风格的音色或语音预览。

1. 创建 API Key

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

   MOSS_API_KEY=<your_api_key_here>

2. 准备请求输入

   按当前场景准备请求参数。同步调用可直接等待结果；耗时任务可传 async=true 和 webhook_url。

   字段类型要求说明

   model: string必填

   moss-voice-generator-1.0

   input: string必填

   要生成语音的文字

   instruction: string必填

   声音风格描述

   delivery_method: string可选

   url 返回 JSON 和结果 URL

   response_format: string可选

   同步请求的音频格式，推荐 mp3

   {
     "model": "moss-voice-generator-1.0",
     "input": "欢迎来到今晚的节目。",
     "instruction": "一个温柔、自然、略带微笑感的年轻女声",
     "delivery_method": "url",
     "response_format": "mp3"
   }

3. 发起第一次请求

   向当前场景的 endpoint 发起请求。同步请求直接返回音频二进制，或在 delivery_method=url 时返回包含结果 URL 的 JSON；async=true 时返回任务对象。

   curl https://api.mosi.cn/v1/audio/voice/generations \
     -H "Authorization: Bearer $MOSS_API_KEY" \
     -H "Content-Type: application/json" \
     -d '{
     "model": "moss-voice-generator-1.0",
     "input": "欢迎来到今晚的节目。",
     "instruction": "一个温柔、自然、略带微笑感的年轻女声",
     "delivery_method": "url",
     "response_format": "mp3"
   }'

   import os
   import requests
   
   resp = requests.post(
       "https://api.mosi.cn/v1/audio/voice/generations",
       headers={
           "Authorization": f"Bearer {os.environ['MOSS_API_KEY']}",
           "Content-Type": "application/json",
       },
       json={
           "model": "moss-voice-generator-1.0",
           "input": "欢迎来到今晚的节目。",
           "instruction": "一个温柔、自然、略带微笑感的年轻女声",
           "delivery_method": "url",
           "response_format": "mp3"
       },
   )
   
   print(resp.status_code)
   print(resp.json())

   const response = await fetch("https://api.mosi.cn/v1/audio/voice/generations", {
     method: "POST",
     headers: {
       Authorization: `Bearer ${process.env.MOSS_API_KEY}`,
       "Content-Type": "application/json",
     },
     body: JSON.stringify({
     "model": "moss-voice-generator-1.0",
     "input": "欢迎来到今晚的节目。",
     "instruction": "一个温柔、自然、略带微笑感的年轻女声",
     "delivery_method": "url",
     "response_format": "mp3"
   }),
   });
   
   console.log(response.status);
   console.log(await response.json());

4. 获取任务结果

   使用 delivery_method=url 同步调用时，从响应 JSON 中读取音色生成结果 URL。传入 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"

5. 验证成功

   成功标志：拿到按描述风格生成的音频或结果 URL，可下载或播放。

下一步