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

Mureka 9.5 歌词成歌 API

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

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

模型概览

模型名称 mureka-9.5/lyrics-to-song
类型 音频生成（歌词成歌）
接口 POST /v1/tasks
价格 见 HiAPI 定价

Mureka 9.5 歌词成歌：输入完整歌词，可补充曲风、情绪与编曲方向，并选择女声或男声主唱，生成包含人声演唱的完整歌曲。

生产建议

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

适用场景

已有成品歌词

歌词已经确定，只需要模型完成演唱、和声与编曲，不再经过自动写词。

lyrics
控制曲风方向

用 prompt 补充曲风、情绪、乐器与节奏，让编曲贴近短视频、品牌歌曲或 demo 的使用场景。

prompt
固定主唱性别

需要女声或男声领唱时显式设置 gender，保持同一角色或系列歌曲的人声一致。

gender

请求参数

model string 必填

固定填 mureka-9.5/lyrics-to-song。

示例 mureka-9.5/lyrics-to-song
input object 必填

业务参数对象；歌词成歌的输入都放在这里。

lyrics string 必填

要演唱的完整歌词，1–5,000 个字符。按行分段、保留主歌与副歌的顺序，模型会据此组织演唱结构和重复段落。

prompt string 可选

可选的曲风与编曲方向，1–2,000 个字符：写清曲风、情绪、乐器、节奏和人声特征。它不会替换歌词，只影响音乐部分。

gender enum 可选

主唱性别倾向：female 为女声，male 为男声。省略时由模型根据歌词与曲风决定。

可选值: femalemale
callback object 可选

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

url string 必填

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

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

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

默认 final 可选值: final

用例示例

完整歌词生成女声流行歌曲

用一首完整的英文主歌与副歌歌词，搭配温暖的独立流行曲风方向和女声主唱。

请求体
{
  "model": "mureka-9.5/lyrics-to-song",
  "input": {
    "lyrics": "[Verse 1]\nCity lights are waking up\nEvery window starts to glow\nWe were chasing something small\nDown the streets we used to know\n[Chorus]\nWe keep moving through the night\nEvery shadow turns to gold\nHold on tight, we are wide awake\nThis is all we need to hold",
    "prompt": "Warm indie-pop song with a bright female lead vocal, chiming guitars, steady live drums and a wide sing-along chorus, hopeful late-night mood.",
    "gender": "female"
  }
}

获取结果

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

常见问题

歌词成歌入口需要提供什么？

lyrics 必填，1–5,000 个字符；prompt 和 gender 可选，分别用于补充曲风编曲方向和选择主唱性别。

可以只写描述、让模型自动写词吗？

当前 HiAPI 的 Mureka 9.5 只开放歌词成歌和纯音乐两个入口，不提供无歌词自动作词模式。需要自动写词时请改用其他音乐模型。

prompt 会替换歌词吗？

不会。有歌词时 prompt 只影响曲风、乐器、节奏和人声质感等音乐部分，演唱文本仍然来自 lyrics。

可以上传参考曲、克隆音色或指定旋律吗？

当前入口不开放参考曲、音色克隆或旋律素材上传，只接受歌词、曲风方向和人声性别。

怎么计费？

按每次成功生成固定计费，与歌词长度和输出时长无关。实时价格以价格页为准。 查看价格页

下一步