Google

Lyria 3.5

lyria-3.5

Google 旗舰音乐生成模型，先规划前奏、主歌、副歌等结构再生成带人声与歌词的完整歌曲，支持多语言演唱，可通过 HiAPI.ai 统一接口调用

lyria-3.5

试用 lyria-3.5

输入

歌词

作品灵感

查看全部作品

输出

audio

填写参数并生成，结果会显示在这里。

价格

lyria-3.5 每首

单价	$0.090

定位简介

Lyria 3.5 是面向文本生成音乐场景的模型，可通过 HiAPI.ai 统一接口调用。它既能用一段音乐描述（流派、乐器、情绪、结构）生成整曲，也能直接提交带 [Verse]、[Chorus] 段落标记的歌词演唱，可指定曲长、BPM、标题与随机种子。输出为带人声的完整歌曲，适合需要快速得到结构分明成品的开发者，用于内容配乐、多语言歌曲与创意 Demo 验证。

核心亮点

按段落组织整首歌，而非片段拼接——生成前先规划前奏、主歌、副歌、桥段等结构，成品段落分明、前后连贯。
描述与歌词二选一即可成曲——只给音乐描述可产出纯音乐或人声作品，只给歌词则直接进入演唱生成。
曲长与速度可在请求中约束——可指定 1 至 240 秒的目标时长与数值型 BPM，便于按投放位置预留长度。

能力说明

文本描述生成整曲：用最多 10000 字符的描述交代流派、乐器、情绪与结构，直接得到一首完整曲目，减少人工编曲与剪辑环节。

歌词驱动演唱：提交含段落标记的歌词即可生成带人声的歌曲，并可填写标题，产出可直接试听的词曲 Demo。

时长与速度可控：可请求 1 至 240 秒的目标时长并指定 BPM；实际输出时长可能与请求值存在偏差，需按范围而非精确值设计。

随机种子与可复现尝试：可传入数值种子组织多轮生成，但相同设置不保证输出完全一致的音频，适合做变体探索而非确定性复现。

纯音频结果输出：返回音频成品文件，可直接进入素材库或后续分发流程，无需再做格式转换。

适用场景

内容创作者的短视频与播客配乐——输入一段描述氛围与节奏的音乐说明，得到与成片时长匹配的背景音乐，直接放入剪辑时间线使用。
音乐创作者的歌词试听 Demo——提交带 [Verse]、[Chorus] 标记的歌词，产出可试听的演唱版本，用于词曲创意验证与版本比较。
广告与品牌内容的定制配乐——以流派、乐器与情绪描述生成贴合画面调性的原创曲目，作为投放素材的配乐底稿。
游戏与互动媒体的配乐原型——用描述加 BPM 与时长约束批量生成氛围片段，作为关卡或界面音乐的早期原型供团队评审。

限制与选型建议

只支持文本与歌词输入，不接受图像引导；输出为带水印的音频文件，且生成结果不可缓存。单次曲目时长为秒级到数分钟，不适合需要长篇连续配乐或无损高保真交付的场合。实际输出时长与音频细节不保证与请求参数完全一致，相同种子也不能复现同一结果。若需要精确可控的音频编辑、分轨或确定性复现，应评估其他方案；此处更适合快速产出结构完整的歌曲成品。

近期更新

查看更新日志 →

模型上新新增 lyria-3.5 API 文档 Sep 11, 2026

提交生成任务

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

请求头

Authorizationstring必填

账号 API Key，所有请求必填。示例：Bearer YOUR_HIAPI_API_KEY。获取 API Key

Content-Typestring可选

请求体固定按 JSON 解析；如携带，仅接受 application/json（可带 charset），其他取值返回 415。示例：application/json。

Idempotency-Keystring可选

幂等键，最长 255 字节。同账户同键的重试只创建一次任务，重放返回首次 taskId。

幂等键

网络超时或客户端自动重试时，同键只创建一次任务、不会重复扣费（幂等范围 = API Key 所属账户）。建议用业务侧唯一标识做键（如 "order-42"）；同键重放返回首次 taskId，键在首次提交 24 小时后过期。详细的场景矩阵见统一异步接口介绍页。

请求体

modelstring必填

当前固定值：lyria-3.5

routestring可选

当前固定值：default

inputobject必填

lyria-3.5 和线路 default 的业务参数对象，见下方参数表。

bpmstring可选pattern ^[1-9][0-9]*(\.[0-9]+)?$

可选，指定生成曲目的速度（BPM），以数字字符串形式传入，取值至少为 1。

seedstring可选minLength 1pattern ^[0-9]+$

可选，随机种子，以数字字符串形式传入；相同设置不保证生成完全相同的音频。

titlestring可选

可选，为生成的歌曲指定标题。

lengthinteger可选min 1max 240

可选，请求的音频时长（秒），取值范围 1 到 240；实际输出时长可能与此不同。

lyricsstring可选minLength 1pattern \S

可选，歌词内容，可使用 [Verse]、[Chorus] 等段落标签；歌词与音乐描述二者需至少提供一个。

promptstring可选minLength 1maxLength 10000pattern \S

可选，音乐描述，用于说明风格、乐器、情绪与结构；音乐描述与歌词二者需至少提供一个。

callbackobject可选

终态通知配置；为空则不回调，由调用方自行查询。详见下方回调说明。

回调（Webhook）

创建任务时提供 callback.url，任务终态时 HiAPI 主动 POST 通知你的服务，可免去轮询。回调请求体与任务详情数据结构同构；签名校验、投递重试与幂等说明见统一异步接口介绍页的回调说明。

urlstring必填

callback 存在时必填；任务终态后向该 URL 发起 POST，须为合法 http(s) URL。

whenstring可选默认值: "final"

当前仅支持 final，即 success / fail 均回调。

可选项：final

storagestring可选默认值: "temp"

产物存储档位：temp（默认，保留约 7 天）或 persistent（长期保存，按大小计费）。余额不足或超出存储上限会静默降级为 temp；实际生效档位见任务详情响应。

可选项：temppersistent

请求示例

# 提交异步任务，成功立即返回 taskId（不等待生成完成）
curl -X POST "https://api.hiapi.ai/v1/tasks" \
  -H "Authorization: Bearer $HIAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "lyria-3.5",
  "input": {}
}'

const res = await fetch("https://api.hiapi.ai/v1/tasks", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.HIAPI_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    model: "lyria-3.5",
    input: {}
  }),
});
const task = await res.json();
// { code: 200, message: "success", data: { taskId } }

import os, requests

res = requests.post(
    "https://api.hiapi.ai/v1/tasks",
    headers={"Authorization": f"Bearer {os.environ['HIAPI_API_KEY']}"},
    json={
        "model": "lyria-3.5",
        "input": {}
    },
)
print(res.json())  # { code, message, data: { taskId } }

200 OK

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR"
  }
}

400 Bad Request

{
  "code": 400,
  "message": "invalid request",
  "data": null,
  "error_code": "INVALID_REQUEST"
}

获取任务详情

GET https://api.hiapi.ai/v1/tasks/:id

响应字段

taskIdstring必填

任务 ID，前缀固定 tk-hiapi-。

modelstring必填

解析后的模型全名。用 route 参数提交的任务返回 base@线路（如 gpt-image-2/text-to-image@ext）；否则与创建时传入的模型名一致。

routestring可选

仅当任务用显式 route 参数提交时出现，回显提交时的原值。

statusstring必填

任务状态。

状态枚举

queued 已入队，尚未开始。 handling 处理中。 archiving 处理完成，产物准备中。 success 终态：完成，产物可用（返回 output）。 fail 终态：失败（返回 error）。提交后按 status 判断：success 或 fail 为终态，其余为非终态，建议按 1~3 秒间隔轮询直至终态。成功终态后从 output[].url 下载产物，并在 expireAt 前完成下载或转存；需要长期保留时在创建任务时使用 storage: "persistent"。

creatednumber必填

任务创建时间（Unix 秒）。

completednumber必填

进入终态的 Unix 秒；非终态固定为 0。

outputarray可选

仅 status == success 时出现。产物列表，始终为数组，同一任务可能同时返回多个 type（如 video + first_frame）。

Array [ object ]

数组元素

urlstring必填

资源 URL，可直接下载。

typestring必填

当前可能值：video、image、audio、first_frame、last_frame、thumbnail，后续可能会扩展。

expireAtnumber必填

资源可访问截止时间（Unix 秒）；过期前请完成下载或转存。

errorobject可选

仅 status == fail 时出现。

codestring必填

业务错误码。

messagestring必填

错误描述。

响应示例

成功

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-01HZTQ8BX2N3GM3YFK4Z9D7VQR",
    "model": "happyhorse-1-0",
    "status": "success",
    "created": 1777282033,
    "completed": 1777282099,
    "output": [
      {
        "url": "https://cdn.hiapi.ai/tasks/.../video.mp4",
        "type": "video",
        "expireAt": 1777886899
      }
    ]
  }
}

处理中（非终态）

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "archiving",
    "created": 1777282033,
    "completed": 0
  }
}

失败

{
  "code": 200,
  "message": "success",
  "data": {
    "taskId": "tk-hiapi-...",
    "model": "happyhorse-1-0",
    "status": "fail",
    "created": 1777282033,
    "completed": 1777282099,
    "error": {
      "code": "TASK_FAILED",
      "message": "task failed"
    }
  }
}