Lyria 3.5 API

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

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

模型概览

模型	lyria-3.5
输入	音乐描述或歌词
输出	音频

根据音乐描述与可选歌词生成歌曲，可设置歌曲标题、节拍意向和随机种子。

请求参数

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

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
# 把 YOUR_API_KEY 换成你的账号 API Key
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "lyria-3.5",
  "input": {
    "bpm": "90",
    "length": 30,
    "prompt": "Warm instrumental indie folk, fingerpicked acoustic guitar, soft brushed drums, quiet morning."
  }
}'

import requests, json

# 业务参数对象，字段随模型而定（见对应模型页）
payload = json.loads(r'''
{
  "model": "lyria-3.5",
  "input": {
    "bpm": "90",
    "length": 30,
    "prompt": "Warm instrumental indie folk, fingerpicked acoustic guitar, soft brushed drums, quiet morning."
  }
}
''')

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
resp = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"},
    json=payload,
)
print(resp.json())  # 成功返回 { code, message, data: { taskId } }

// 提交异步任务，成功立即返回 taskId（不等待生成完成）
// 把 YOUR_API_KEY 换成你的账号 API Key
const resp = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
  "model": "lyria-3.5",
  "input": {
    "bpm": "90",
    "length": 30,
    "prompt": "Warm instrumental indie folk, fingerpicked acoustic guitar, soft brushed drums, quiet morning."
  }
}),
});
console.log(await resp.json()); // 成功返回 { code, message, data: { taskId } }

model string 必填

示例 lyria-3.5

input object 必填

prompt string 可选

描述曲风、乐器、情绪、人声和歌曲结构。prompt 与 lyrics 至少填写一项。

lyrics string 可选

歌词文本，每行一句。基础段落标记为 [Intro]（前奏）、[Verse]（主歌）、[Chorus]（副歌）、[Bridge]（桥段）、[Outro]（尾奏）；标记独占一行，下一行开始填写歌词。重复主歌可写成 [Verse 1]、[Verse 2]，详见下方结构标记表。

title string 可选

歌曲标题。

bpm string 可选

节拍意向，以数字字符串传入，例如 "90"。

length integer 可选

期望生成时长，单位为秒，取值 1–240 的整数。用于引导歌曲长度，实际音频时长可能变化；不传时不指定。

seed string 可选

文本形式的随机种子，不能据此保证音频完全复现。

callback object 可选

url string 必填

when enum 可选

默认 final 可选值: final

歌词结构标记

将标记写在歌词文本中，引导段落编排；不需要每首歌都使用全部标记。

标记	含义	写法
[Intro]	前奏	`放在歌曲开头。`
[Verse]	主歌	`后接主歌歌词；多个主歌可编号为 [Verse 1]、[Verse 2]。`
[Chorus]	副歌	`后接歌曲主要旋律段的歌词。`
[Bridge]	桥段	`标记连接或变化段落。`
[Outro]	尾奏	`放在歌曲结尾。`

用例示例

带着晨光

用原声流行风格和自填歌词生成歌曲。

请求体

{
  "model": "lyria-3.5",
  "input": {
    "bpm": "90",
    "length": 30,
    "prompt": "Warm instrumental indie folk, fingerpicked acoustic guitar, soft brushed drums, quiet morning."
  }
}

获取结果

创建任务后，从 data.taskId 读取任务 ID。
使用 GET /v1/tasks/{taskId} 查询进度，直到 data.status 为 success 或 fail。
成功后，从 data.output 中找到 type=audio 的条目，通过 url 获取音频。

常见问题

怎样使用自己写的歌词？

将歌词放入 lyrics，在 prompt 中描述曲风、乐器和人声。歌词段落可以使用上表的结构标记。

怎样创作纯音乐？

在 prompt 中明确写出“纯音乐、无人声”或 “instrumental only”，并描述乐器与情绪；lyrics 留空。

这个接口可以接收图片吗？

本接口接收音乐描述和歌词，不提供图片输入参数。

下一步

在线体验