Google

Lyria 3.5

lyria-3.5

Googleのフラッグシップ音楽生成モデル。イントロ、ヴァース、サビなどの構造をまず計画してから、ボーカルと歌詞付きの完成楽曲を生成します。多言語での歌唱に対応し、HiAPI.ai の統一インターフェース経由で呼び出せます

lyria-3.5

lyria-3.5 を試す

入力

Lyrics

作品ギャラリー

すべての作品を見る

出力

audio

パラメータを入力して生成すると、結果がここに表示されます。

料金

lyria-3.5 per song

単価	$0.090

位置づけの概要

Lyria 3.5 はテキストから音楽を生成するシーン向けのモデルで、HiAPI.ai の統合インターフェースを通じて呼び出せます。楽曲の説明（ジャンル、楽器、ムード、構成）から一曲全体を生成できるほか、[Verse]、[Chorus] のセクションタグ付きの歌詞をそのまま投入して歌唱させることも可能で、曲の長さ、BPM、タイトル、ランダムシードを指定できます。出力はボーカル付きの完成した楽曲で、構造の明確な完成品を素早く得たい開発者に適しており、コンテンツのBGM、多言語楽曲、クリエイティブなデモ検証などに活用できます。

主な特長

断片の寄せ集めではなく、セクション単位で曲全体を構成——生成前にイントロ、Aメロ、サビ、ブリッジなどの構造を計画するため、完成品はセクションが明確で前後が一貫しています。
説明文か歌詞のどちらか一方だけで曲に——音楽の説明だけを与えればインストゥルメンタルまたはボーカル作品を生成でき、歌詞だけを与えればそのまま歌唱生成に入ります。
曲の長さとテンポをリクエストで制約可能——1〜240秒の目標尺と数値型のBPMを指定でき、掲載位置に合わせて長さを確保しやすくなります。

機能説明

テキスト説明から曲全体を生成：最大10000文字の説明でジャンル、楽器、ムード、構成を伝え、そのまま一曲全体を取得できるため、手作業の編曲や編集の工程を削減できます。

歌詞駆動の歌唱：セクションタグを含む歌詞を投入すればボーカル付きの楽曲を生成でき、タイトルも記入可能なため、そのまま試聴できる詞曲デモを生み出せます。

長さとテンポを制御可能：1〜240秒の目標尺をリクエストしBPMを指定できますが、実際の出力尺はリクエスト値とずれる場合があるため、範囲ベースで設計し、正確な値を前提にしないでください。

ランダムシードと再現を試みる反復生成：数値のシードを渡して複数回の生成を整理できますが、同じ設定でも完全に同一の音声が出力される保証はなく、確定的な再現ではなくバリエーション探索に向いています。

音声のみの結果出力：音声の完成ファイルを返すため、そのまま素材ライブラリや後続の配信フローに投入でき、形式変換は不要です。

適用シーン

コンテンツクリエイターのショート動画・ポッドキャストBGM——雰囲気とリズムを説明する音楽指示を入力し、完成映像の尺に合ったBGMを取得して、そのまま編集タイムラインに配置できます。
音楽クリエイターの歌詞試聴デモ——[Verse]、[Chorus] タグ付きの歌詞を投入し、試聴可能な歌唱版を出力して、詞曲のアイデア検証やバージョン比較に利用できます。
広告・ブランドコンテンツ向けのオーダーメイドBGM——ジャンル、楽器、ムードの説明で映像のトーンに合ったオリジナル曲を生成し、配信素材のBGM下書きとして活用できます。
ゲーム・インタラクティブメディアのBGMプロトタイプ——説明にBPMと尺の制約を加えて雰囲気の断片を大量生成し、ステージやUI音楽の初期プロトタイプとしてチームレビューに供せます。

制限と選定のアドバイス

入力はテキストと歌詞のみに対応し、画像による誘導は受け付けません。出力はウォーターマーク付きの音声ファイルで、生成結果はキャッシュできません。1回の楽曲尺は秒単位から数分程度であるため、長尺の連続BGMやロスレス高忠実度の納品が必要な場面には向きません。実際の出力尺や音声の細部がリクエストパラメータと完全に一致する保証はなく、同じシードでも同一の結果を再現できません。精緻で制御可能な音声編集、ステム分離、確定的な再現が必要な場合は他の方案を検討すべきです。ここは構造の整った楽曲完成品を素早く生み出す用途に適しています。

最新情報

更新履歴を見る →

新しいモデル lyria-3.5 API ドキュメントを追加 Sep 11, 2026

生成タスクの作成

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

ヘッダー

Authorizationstring必須

アカウントの API キー。すべてのリクエストで必須です。例：Bearer YOUR_HIAPI_API_KEY。API キーを取得

Content-Typestring任意

リクエストボディは常に JSON として解析されます。送信する場合は application/json（charset 付き可）のみ受け付け、他の値は 415 を返します。例：application/json。

Idempotency-Keystring任意

冪等キー。最大 255 バイト。同じアカウントで同じキーの再試行はタスクを 1 つだけ作成し、リプレイは最初の taskId を返します。

冪等キー

ネットワークタイムアウトやクライアントの自動再試行時、同じキーではタスクを 1 回だけ作成し、二重課金は発生しません（適用範囲 = API キーのアカウント）。業務側の一意識別子（例："order-42"）をキーに使うことを推奨します。同じキーのリプレイは最初の taskId を返し、キーは初回送信から 24 時間で失効します。詳細なシナリオ表は統一非同期 API の紹介ページをご覧ください。

ボディ

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 し、ポーリングが不要になります。コールバックのリクエストボディはタスク詳細と同構造です。署名検証・再送・冪等の詳細は統一非同期 API 紹介ページのコールバック説明を参照してください。

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@route（例：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 のときのみ出現。成果物リスト — 常に配列で、1 タスクで複数の 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"
    }
  }
}