Lyria 3.5 / Lyria 3 Pro Preview 音乐生成

使用音乐描述生成纯音乐或带人声的歌曲。两个模型均为 ¥0.30/次调用，直接使用最新完整模型 ID，通过知梦 API 的 Chat Completions 调用。

模型	请求中的 model	能力与输出	价格
Lyria 3.5	lyria-3.5	音乐 / 歌曲生成，MP3	¥0.30/次
Lyria 3 Pro Preview	lyria-3-pro-preview	高质量版音乐生成，MP3	¥0.30/次

两者参数相同。“高质量版”不代表支持更多参数、更长时长或严格逐字演唱；未公开这些差异的量化保证。

调试 Lyria 3.5 · 调试 Lyria 3 Pro Preview · 通用协议、SDK 示例与错误处理 · 价格

接口和完整参数

POST https://api.zmoapi.cn/v1/chat/completions
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

兼容客户端 Base URL 为 https://api.zmoapi.cn/v1。请求为 JSON，使用知梦 API 密钥。

参数	类型	必填	说明
model	string	是	lyria-3.5 或 lyria-3-pro-preview。
messages	object[]	是	推荐一条 user 消息；实际音频输入取最后一条 user 文本。
messages[0].role	string	是	本页示例固定 user。
messages[0].content	string	是	非空音乐描述，可写风格、乐器、情绪、语言、人声、节奏和歌词。英文风格描述通常更稳定，但不承诺特定语言的准确程度。
stream	boolean	否	默认示例 false，同步等待 JSON；可传 true 使用 SSE，音频仍在最后一次交付。
output_format	string	否	url（Chat 默认）、base64 或 both，分别返回临时链接、MP3 Data URI、两者同时返回。
temperature	number	否	网关 Chat 参数范围 0–2；不传则使用服务端默认。音频默认值及对音频的精确影响未明确，不作为风格或复现保证。
stream_options.include_usage	boolean	否	仅流式可请求用量块，实际是否返回看响应；不改变每次 ¥0.30 的公开售价。

Lyria 固定输出 MP3，不发送 TTS 的 audio.voice、audio.format 或 speakers。当前 Chat 没有明确的音色库、精确秒数、参考音频、延长、翻唱、分轨或音频编辑参数；不要把这些当作已接入能力。

纯音乐

在消息中明确写“纯音乐，不要人声”，并描述曲风与用途：

curl 'https://api.zmoapi.cn/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "lyria-3.5",
    "messages": [{"role":"user","content":"温暖的 lo-fi 爵士纯音乐，电钢琴与轻柔鼓点，适合夜间阅读，不要人声"}],
    "stream": false,
    "output_format": "url"
  }'

歌曲与自备歌词

音乐描述和歌词均放在 messages[0].content；使用分段文字明确说明它们的用途。这里不发送顶层 lyrics 或 prompt，也不需要修改协议。调试台的“歌词”编辑框只是将文字附加到同一条消息，完整请求预览可见实际文本。

curl 'https://api.zmoapi.cn/v1/chat/completions' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  --data-raw '{
    "model": "lyria-3-pro-preview",
    "messages": [{
      "role": "user",
      "content": "生成中文流行歌曲，温柔女声，钢琴与弦乐，舒缓抒情。请参考以下歌词创作。\n\n歌词：\n[Verse]\n晚风轻轻穿过街道\n你的笑容我还记得\n\n[Chorus]\n让时间慢一点\n让你留在我身边"
    }],
    "stream": false,
    "output_format": "url"
  }'

歌词、[Verse] / [Chorus]、BPM、目标时长均作为创作提示；不保证逐字演唱、严格分段、精确 BPM 或精确时长。实际音频以结果为准，没有独立 duration / seconds 参数。

URL、Base64 与流式

通过 output_format 指定交付方式。both 模式的 Chat 正文示意（省略号非真实 Base64）：

[[A0]]
[[B1]]
<audio controls src="https://example.com/song.mp3"></audio>
<audio controls src="data:audio/mpeg;base64,..."></audio>

前面的文本可能是模型附带的结构 / 歌词信息，可以保留展示，不把它当成音频数据。解析音频标签的 src；Chat 不保证提供 data[].duration、title、download_url 或 url_expires_at。

url（默认）只返回临时 MP3 链接；base64 只返回 data:audio/mpeg;base64,...；both 先返回链接，再返回 Base64，二者是同一份音频，不是多生成一首。下载 URL 时保留全部签名参数且不附加知梦 API Key；Base64 去掉前缀解码，保存为 .mp3。

把 stream 改成 true 可使用 SSE；累积 choices[].delta.content，直到正常结束再提取音频。HTTP 200 + 正文“错误: …”仍是失败；音频不是逐段推送。完整字段和错误处理见 音频 API 概览。

建议读取超时至少 180 秒；一首生成约 20–60 秒仅为参考。无需查询任务，也没有本文接入的取消或任务列表接口。URL 为临时链接，请及时下载；Base64 可直接解码并保存到自己的存储。不承诺固定链接有效期或刷新能力。

调试与计费

调试台选择“Google 音频”及目标 Lyria 模型。填写描述，可另外输入歌词；可选择 URL / Base64 / both 返回，可选择非流式 / SSE，可选 temperature。确认“完整请求”后提交，结果支持 MP3 试听与下载，原始响应保留结构 / 歌词文本。

每次真实调用 ¥0.30。客户端超时不等于没有执行；先核对消费记录，不无条件自动重试。