使用 lyria-3.5 制作电商广告音乐（而非产品图片）

Lyria 3.5 生成的是音乐而非产品照片——以下是将其用于电商的正确方式

如果你搜索过“lyria-3.5 产品图片”，简短的回答是：lyria-3.5 是 hiapi 的文本生成音乐模型——它无法生成产品照片。它没有图像输出，没有 image_urls 字段，其 schema 中根本没有任何视觉相关内容。它的真正用途是背景音乐和配乐，而对于电商卖家来说，这恰恰是一个真实且未被充分满足的需求：每个产品视频、广告和社交短片都需要配乐，而授权素材音乐比大多数团队预期的更慢、更贵。

本指南展示真正可行的场景：使用 lyria-3.5 为电商产品视频和广告生成免版税背景音乐，包含一个真实的请求、一个真实的响应，以及我们为本文生成的真实曲目。

为什么这个场景适合 lyria-3.5

hiapi 对 lyria-3.5 的官方模型描述明确点名广告为预期用例——与播客和独立流行 demo 并列。这不是我们的牵强附会，而是平台自己的定位。电商广告音乐完全属于这一范畴：

• 产品演示视频（Shopify/TikTok Shop 风格）需要 15–40 秒的器乐铺底，且不能与人声解说争抢。
• 付费社交广告需要“欢快、有活力”的情绪来传达促销或新品发布，同时避免授权麻烦。
• 店铺背景播放列表（直播带货、应用内视频）需要多样性，同时不必为每首曲目支付同步授权费。

Lyria 3.5 能在约一分钟内根据文本提示生成完整的器乐曲（如果你提供歌词，也可以是人声曲目），每首歌 0.09 美元——足够便宜，可以为每个活动生成几个变体并挑选最佳的一个，这正是使用生成式音乐模型的正确方式：作为初稿，而非一次性最终素材。

一次真实生成：提示词、请求、响应

以下是我们使用的确切提示词以及它生成的确切曲目——没有经过编辑，也没有从批次中挑选。

提示词：

Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals

请求（hiapi 统一的异步任务 API）：

curl -s -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": {
      "prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, bright plucked synths, punchy four-on-the-floor beat, warm bass groove, optimistic and energetic mood, radio-ready polish, no vocals"
    }
  }'

这会立即返回一个任务 ID；音乐生成以异步方式运行，与 hiapi 的图像和视频模型相同。

轮询直至终态：

curl -s https://api.hiapi.ai/v1/tasks/tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V \
  -H "Authorization: Bearer $HIAPI_API_KEY"

完成后的响应（已精简）：

{
  "id": "tk-hiapi-01M2HM4T0RG0XQNS6TFE9QF14V",
  "status": "success",
  "output": [
    {
      "title": "Bright Shelf",
      "url": "https://temp.hiapi.ai/7c6ttvrbpt/01M2HM4T0RG0XQNS6TFE9QF14V-0.m4a"
    }
  ],
  "expireAt": 1790050272
}

在此处聆听实际结果：Bright Shelf——lyria-3.5 输出（.m4a）。此链接是临时输出 URL，大约在生成后 7 天过期——如果你想保留文件，请自行下载并重新托管。这对所有 hiapi 任务输出都是标准做法，包括音频：任务完成后立即获取字节并存储到你自己的 bucket 中。

模型自行将曲目命名为“Bright Shelf”——lyria-3.5 会在音频旁自动生成一个短标题，如果你正在为某个活动整理音乐库，这是一个不错的细节。

Python 等效代码

import requests
import time

API_KEY = "your-hiapi-key"
BASE = "https://api.hiapi.ai/v1"

resp = requests.post(f"{BASE}/tasks", headers={"Authorization": f"Bearer {API_KEY}"}, json={
    "model": "lyria-3.5",
    "input": {
        "prompt": "Upbeat modern electronic-pop instrumental for an e-commerce product ad, "
                  "bright plucked synths, punchy four-on-the-floor beat, warm bass groove, "
                  "optimistic and energetic mood, radio-ready polish, no vocals"
    }
})
task_id = resp.json()["id"]

while True:
    task = requests.get(f"{BASE}/tasks/{task_id}", headers={"Authorization": f"Bearer {API_KEY}"}).json()
    if task["status"] in ("success", "fail"):
        break
    time.sleep(5)

if task["status"] == "success":
    audio_url = task["output"][0]["url"]
    audio_bytes = requests.get(audio_url).content
    with open("bright_shelf.m4a", "wb") as f:
        f.write(audio_bytes)

Schema：lyria-3.5 实际接受什么

该 schema 故意设计得很窄——这是一个文本生成音乐模型，不是通用音频工具包：

• prompt（string）——如果你不直接提供 lyrics，则此项为必填；描述流派、配器、节奏、情绪。
• lyrics（string，可选）——如果你想要人声曲目而非器乐曲，可传入你自己的歌词。

没有 duration、image_urls 或 reference_audio 字段。如果你发送不支持的字段或空载荷，会收到验证错误，而不是被静默忽略的参数——第一次集成时值得检查响应，因为它会立即告诉你字段名是否错误。

特别关于“产品图片”的混淆：如果你团队的简报说“用 lyria-3.5 生成产品图片”，那个指令基于一个错误的模型。对于实际的产品摄影和广告视觉素材，请使用图像模型——gpt-image-2 是 hiapi 最常用的文本生成图像模型，擅长处理产品图和图上文字。将其与 lyria-3.5 配合用于视频/广告配乐，你就用两次 API 调用覆盖了产品视频的两个部分，而无需订阅素材库。

生产注意事项

• 将每次生成视为草稿。每首歌 0.09 美元，为每个提示词生成 2–3 个变体，然后挑选最适合你剪辑的那个，而不是试图第一次就完善单个提示词。
• 发布前重新托管。temp.hiapi.ai 输出 URL 会过期——不要从线上店铺或广告中链接它；请下载并托管到你自己的 CDN。
• 提示词保持聚焦于情绪和配器。“Upbeat”“warm bass”“no vocals”以及流派标签（electronic-pop、lo-fi、acoustic）比试图描述具体旋律更能可靠地引导输出。
• 如果你需要歌词或更长时长，hiapi 还提供 lyria-3-pro（每首歌 0.14 美元），可生成最长约三分钟的完整歌曲，并支持歌词和多语言——当你从快速广告铺底音乐进阶到品牌主题音乐时，它值得一试。

常见问题

lyria-3.5 能为电商 listing 生成产品图片吗？ 不能。Lyria 3.5 是文本生成音乐模型，没有图像输出。对于产品照片，请使用 hiapi 上的图像模型，例如 gpt-image-2。

一首 lyria-3.5 曲目要多少钱？ 每首生成的歌曲 0.09 美元，按任务计费，无论曲目最终如何使用。

生成需要多长时间？ 在我们的测试中，从提交任务到完成可下载的曲目大约需要一分钟。

我可以获得人声而非器乐曲吗？ 可以——在请求中传入你自己的 lyrics，替代（或配合）情绪/流派 prompt。

输出对于商业广告是免版税的吗？ 曲目是专门针对你的提示词生成的，不是授权样本——像对待任何来自 hiapi 的 AI 生成商业素材一样对待它：生成后你可以在广告中使用它，但请自行重新托管，因为交付 URL 会过期。

相关链接

• lyria-3.5 模型页面——实时定价、schema 和试用操场。
• hiapi 定价——将 lyria-3.5 与所有其他音频、图像和视频模型进行比较。
• hiapi API 文档——适用于所有模型类型异步生成的完整 /v1/tasks 参考。
• minimax-music-3 API：curl 与 Python 指南——如果你想要更长或风格不同的曲目，这是第二个音乐模型。

准备好尝试了吗？从你的仪表盘获取 API 密钥，并用上面的请求生成你的第一首曲目——这是一次调用、一分钟的测试。