音色生成

根据文本与声音描述生成音色或语音预览。该接口用 input（待合成文本）+ instruction（声音风格描述）驱动生成。

POST

/v1/audio/voice/generations

据文本生成音色/语音预览。请求体为 JSON；delivery_method=url 返回 JSON（含结果 URL），delivery_method=audio（默认）返回音频二进制。

认证

在请求头中加入 Authorization: Bearer <API_KEY> 完成鉴权，密钥可在控制台「API 密钥」页生成。

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

支持模型

字段	允许值
model	`moss-voice-generator`

请求字段

字段	类型	必填	说明
model	string	是	模型名称，取值为 `moss-voice-generator`。
version	string	否	可显式指定 `moss-voice-generator-v1`；不传时使用服务端默认版本。
input	string	是	要生成语音的文本。
instruction	string	是	声音风格、年龄、情绪、语速等描述。
response_format	string	否	同步请求的音频格式，例如 `mp3` / `wav`；异步任务不保证按该字段输出。
delivery_method	string	否	`audio` 直接返回音频二进制；`url` 返回 JSON 和结果 URL。
async	boolean	否	设为 `true` 时创建异步任务并立即返回任务对象。
webhook_url	string	否	异步任务完成后回调的 HTTPS URL。

请求示例

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",
    "input": "欢迎来到今晚的节目。",
    "instruction": "一个温柔、自然、略带微笑感的年轻女声",
    "delivery_method": "url",
    "response_format": "mp3"
  }'

同步 URL 响应字段

delivery_method=url 时返回 JSON（含结果 URL）：

字段	类型	必返	说明
id	string	是	任务/结果 ID。
object	string	是	固定为 `audio.voice_generation`。
status	string	是	任务状态，例如 `SUCCESS`。
url	string	是	音频结果 URL。
response_format	string	是	实际输出音频格式，例如 `mp3` / `wav`。
content_type	string	是	音频 MIME 类型，例如 `audio/mpeg` / `audio/wav`。
created_at	integer	是	创建时间，Unix 时间戳，单位为秒。

响应示例

{
  "id": "task_abc123",
  "object": "audio.voice_generation",
  "status": "SUCCESS",
  "url": "https://cdn.example.com/out.mp3",
  "response_format": "mp3",
  "content_type": "audio/mpeg",
  "created_at": 1710000000
}

同步音频响应字段

不传 delivery_method 或 delivery_method=audio 时：

字段	类型	必返	说明
Content-Type	HTTP header	是	音频 MIME 类型，例如 `audio/mpeg` / `audio/wav`。
body	binary	是	音频二进制内容。

异步创建响应字段

async=true 时立即返回：

字段	类型	必返	说明
id	string	是	任务 ID。
task_id	string	是	任务 ID；查询任务时使用该值。
object	string	是	固定为 `audio.voice_generation`。
status	string	是	创建后的任务状态，例如 `PENDING`。
model_id	string	是	实际使用的模型名称。
model_version	string	是	实际使用的模型版本。
retry_after	integer	否	建议再次查询任务前等待的秒数。
created_at	integer	是	创建时间，Unix 时间戳，单位为秒。
updated_at	integer	否	更新时间，Unix 时间戳，单位为秒。

下一步

查询音色列表

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

单人语音生成

文本转语音接口。