跳转到内容
HiAPI Docs
HiAPI
在线试用 获取 API Key
中文
English 中文

Google Lyria 3 Pro API

POST Base URL: https://api.hiapi.ai /v1/tasks

图片、视频和音频模型通过 统一异步接口 POST /v1/tasks 调用，区别只在 input 字段（见下方 input 参数）。

模型概览

模型名称 lyria-3-pro
类型 音频生成（text-to-music）
接口 POST /v1/tasks
价格 见 HiAPI 定价

根据提示词和可选灵感图片生成最长约 3 分钟的完整歌曲；图片用于启发音乐，不是视频首帧或音频源素材。

生产建议

生产环境建议
  • 生产环境建议在请求体顶层传 callback.url，让 HiAPI 在任务进入终态时主动通知你的服务，减少无效轮询。
  • GET /v1/tasks/:id 更适合本地调试、低频任务，或作为回调失败后的补偿查询。
  • callback.when 当前建议固定为 final；success 和 fail 都可能触发终态通知，你的服务端需要按 taskId 做幂等处理。

适用场景

完整歌曲生成

用一段风格和结构提示词生成最长约 3 分钟的完整歌曲，包含人声和编曲。

prompt
图片灵感配乐

传入一到十张灵感图片，让音乐的情绪、主题和编曲呼应视觉素材；图片只用于音乐创作启发。

image_urlsprompt
歌词与段落控制

在提示词中使用歌词、[Verse]、[Chorus] 和时间戳引导歌曲结构。

prompt

请求参数

model string 必填

固定填 lyria-3-pro。

示例 lyria-3-pro
input object 必填

业务参数对象；Google Lyria 3 Pro 的模型专属配置都放在这里。

prompt string 必填

描述曲风、乐器、情绪、速度、歌词和歌曲结构；可使用 [0:00 - 0:30] 等时间戳引导编排。

image_urls string[] 可选

可选灵感图片，用于启发音乐的情绪和主题；图片不会作为音频源素材。

seed integer 可选

可选随机种子，用于提高复现性；相同输入不保证完全一致。

callback object 可选

可选回调配置；设置后任务进入终态时 HiAPI 会主动通知你的服务，减少轮询。

url string 必填

传入 callback 时必填；接收任务终态通知的 HTTPS 地址。

示例 https://your-domain.com/hiapi/callback
when enum 可选

回调触发时机；当前建议固定为 final。

默认 final 可选值: final

用例示例

图片灵感配乐

传入灵感图片，让音乐贴合图片的色彩和氛围；图片只用于音乐创作启发。

请求体
{
  "model": "lyria-3-pro",
  "input": {
    "prompt": "Create an atmospheric ambient song inspired by the mood and colors in the inspiration image, with gentle piano, strings, and a gradual cinematic rise.",
    "image_urls": [
      "https://tjzk.replicate.delivery/models_models_featured_image/22671d81-7e89-4db5-bd35-0d2c514fd74e/Lyria-3-Pro_thumbnail.width-13.png"
    ]
  }
}
夏夜独立流行

用风格、乐器和段落提示词生成一首完整歌曲。

请求体
{
  "model": "lyria-3-pro",
  "input": {
    "prompt": "A warm indie-pop song with acoustic guitar, soft drums, and a hopeful summer-night chorus. Include clear verse and chorus sections."
  }
}

获取结果

  1. 提交成功后立即返回 taskId（不等待生成完成）。
  2. 生产环境优先等待 callback.url 收到终态通知；本地调试时可轮询 GET /v1/tasks/:id。
  3. status=success 后，从返回的 output[].url 下载生成的音频。
  4. 如果 status=fail，按返回的错误信息修正请求，不要盲目重试同一个无效请求。

常见问题

最长可以生成多长的歌曲？

Lyria 3 Pro 最长约 3 分钟；实际时长可通过提示词和时间戳引导。

最多可以传几张灵感图片？

最多十张灵感图片，放在 input.image_urls 数组中。它们用于启发音乐的情绪、主题和编曲，不是视频式首帧。

如何控制歌词和段落？

把歌词和 [Verse]、[Chorus]、[Bridge] 等结构标签直接写进 prompt。

下一步