HiAPI
Ja
ブログ

使用ガイド

lyria-3.5 でEC広告音楽を作る（製品画像ではなく）

lyria-3.5 はテキストから音楽を生成するモデルであり、画像モデルではありません。以下では、これをEC製品動画や広告に実際に活用する方法を説明します。

Sep 15, 2026
lyria-3.5 でEC広告音楽を作る（製品画像ではなく）

Lyria 3.5 が生成するのは製品写真ではなく音楽——ECで正しく活用する方法

「lyria-3.5 製品画像」で検索したことがあるなら、短い答えはこうです：lyria-3.5 は hiapi のテキストから音楽を生成するモデルであり、製品写真を生成することはできません。画像出力はなく、image_urls フィールドもなく、そのスキーマには視覚に関連する内容が一切含まれていません。その真の用途はBGMと劇伴であり、EC販売者にとってこれはまさに現実的で十分に満たされていないニーズです。すべての製品動画、広告、ソーシャル用短編動画にはBGMが必要であり、ライセンス済みのストック音楽は多くのチームが想定するより遅く、高価です。

本ガイドでは実際に可能なシナリオを紹介します。lyria-3.5 を使ってEC製品動画や広告向けのロイヤリティフリーBGMを生成する方法で、実際のリクエスト、実際のレスポンス、そして本記事のために生成した実際のトラックを含みます。

なぜこのシナリオが lyria-3.5 に適しているのか

hiapi による lyria-3.5 の公式モデル説明は、ポッドキャストやインディーポップのデモと並んで、広告を想定ユースケースとして明確に挙げています。これは私たちのこじつけではなく、プラットフォーム自身の位置づけです。EC広告音楽はまさにこの範疇に属します：

  • 製品デモ動画（Shopify/TikTok Shop スタイル）には15～40秒のインストゥルメンタル下地が必要で、しかもナレーションと競合してはいけません。
  • 有料ソーシャル広告には、プロモーションや新製品発表を伝える「明るく活気ある」ムードが必要で、同時にライセンスの煩雑さを避ける必要があります。
  • 店舗用BGMプレイリスト（ライブコマース、アプリ内動画）には多様性が必要で、同時に曲ごとにシンクロライセンス料を支払う必要はありません。

Lyria 3.5 はテキストプロンプトから約1分で完全なインストゥルメンタル曲（歌詞を提供すればボーカル曲も可能）を生成でき、1曲あたり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 タスク出力に共通する標準的な仕様です。タスク完了後すぐにバイトを取得し、ご自身のバケットに保存してください。

モデルは自らトラックを「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)

スキーマ：lyria-3.5 が実際に受け付けるもの

このスキーマは意図的に狭く設計されています。テキストから音楽を生成するモデルであり、汎用オーディオツールキットではありません：

  • prompt（string）——lyrics を直接提供しない場合に必須。ジャンル、編成、リズム、ムードを記述します。
  • lyrics（string、任意）——インストゥルメンタルではなくボーカル曲が欲しい場合、独自の歌詞を渡せます。

duration、image_urls、reference_audio フィールドはありません。サポートされていないフィールドや空のペイロードを送信すると、黙って無視されるのではなく検証エラーが返ります。初回の統合時にレスポンスを確認する価値があるのは、フィールド名が誤っているかどうかを即座に教えてくれるからです。

特に「製品画像」の混同について：チームのブリーフに「lyria-3.5 で製品画像を生成する」とあるなら、その指示は誤ったモデルに基づいています。実際の製品撮影や広告ビジュアル素材には画像モデルを使用してください。gpt-image-2 は hiapi で最もよく使われるテキストから画像を生成するモデルで、製品画像や画像上の文字の処理に優れています。これを lyria-3.5 と動画・広告のBGM用に組み合わせれば、ストックライブラリのサブスクリプションなしで、2回のAPI呼び出しで製品動画の2つの部分をカバーできます。

本番運用上の注意点

  • 各生成を草稿として扱う。1曲0.09ドルなので、プロンプトごとに2～3のバリエーションを生成し、編集に最も合うものを選びましょう。単一のプロンプトを一発で完璧にしようとしないでください。
  • 公開前に再ホスティングする。temp.hiapi.ai の出力URLは期限切れになります。オンラインショップや広告からリンクしないでください。ダウンロードしてご自身のCDNにホスティングしてください。
  • プロンプトはムードと編成に焦点を当てる。「Upbeat」「warm bass」「no vocals」やジャンルタグ（electronic-pop、lo-fi、acoustic）は、具体的なメロディを描写しようとするよりも確実に出力を導きます。
  • 歌詞やより長い尺が必要な場合、hiapi では lyria-3-pro（1曲0.14ドル）も提供しており、最長約3分のフルソングを生成でき、歌詞や多言語に対応しています。素早い広告下地音楽からブランドテーマ音楽へ進む際に試す価値があります。

よくある質問

lyria-3.5 はECリスティング用の製品画像を生成できますか？ いいえ。Lyria 3.5 はテキストから音楽を生成するモデルであり、画像出力はありません。製品写真には、hiapi の画像モデル（例：gpt-image-2）を使用してください。

lyria-3.5 の1曲はいくらですか？ 生成された曲1曲あたり0.09ドルで、タスク単位で課金され、トラックの最終的な用途に関わらず同じです。

生成にはどのくらい時間がかかりますか？ 私たちのテストでは、タスク送信からダウンロード可能なトラックの完成まで約1分です。

インストゥルメンタルではなくボーカルを得ることはできますか？ はい。リクエストに独自の lyrics を渡し、ムード・ジャンルの prompt の代わりに（または併用して）指定します。

出力は商用広告に対してロイヤリティフリーですか？ トラックはあなたのプロンプト専用に生成されたもので、ライセンスサンプルではありません。hiapi からの他のAI生成商用素材と同様に扱ってください。生成後は広告で使用できますが、配信URLは期限切れになるため、ご自身で再ホスティングしてください。

関連リンク

試す準備はできましたか？ダッシュボードからAPIキーを取得し、上記のリクエストで最初のトラックを生成してください。1回の呼び出し、1分のテストです。

タグガイドテキストから音楽を生成

関連記事

すべての記事を見る →

永続的なAIアーティファクトで開発を始める

APIキーを取得して、タスクベースの1つのAPIで画像・動画・音声モデルを呼び出せます。

APIドキュメントを読む