はじめに
prompt に音楽の内容、おおよその尺、希望する編曲を書きます。Lyria 3.5 は 44.1 kHz ステレオの MP3 を 1 曲返し、長さによらず曲単位で課金します。提供されたアコースティックフォークのテストは 30 秒の指定に対して 61.6 秒の音声でした。
| 項目 | 値 |
|---|---|
| 入力 | テキスト |
| 出力 | 音声 |
| 音楽モデル | Google DeepMind Lyria 3.5 |
| 対応する入力 | prompt |
| 返されるファイル | MP3 の楽曲 1 曲、44.1 kHz ステレオ |
| エンコードの測定値 | 約 193 kbps |
| 長さの扱い | prompt 内での目安指定。長さのフィールドはありません |
| 課金の単位 | 生成した曲ごと。長さに依存しません |
主な機能とハイライト
音楽の判断を 1 つの指示にまとめる
ジャンル、雰囲気、楽器、テンポ、構成、希望尺はすべて prompt に書きます。ポッドキャストなら控えめな編成と導入モチーフを指定し、動画のモンタージュなら盛り上がりから落ち着きまでを描写してください。返された曲で聴き取って確認できる、具体的な要素が揃います。
曲を聴いてから切り方を決める
アコースティックフォークのテストでは、100 BPM で 30 秒のインストゥルメンタルを依頼し、約 30 秒で 61.6 秒の MP3 が返りました。試聴して切り詰める工程を見込むための参考にしてください。長さを厳密に指定できることや、ジャンルを問わず一定の処理時間になることを示す結果ではありません。
ステレオ MP3 を作品に取り込む
生成ごとに 44.1 kHz ステレオの MP3 が 1 曲返ります。提供されたテストの実測値は約 193 kbps でした。冒頭、中盤、末尾を制作意図と照合してください。ポッドキャストや広告にナレーションがある場合は、ミックスを確定する前に語りの下で音楽を聴きます。
試す案の数から費用を考える
課金の単位は生成した曲で、曲の長さに比例しません。表示単価を確認し、生成して比較する価値のある prompt の案を選びます。短い尺を指定すると音楽への指示は変わりますが、課金単位は変わりません。
リクエストパラメーター
| パラメーター | 必須 | 説明 |
|---|---|---|
prompt | はい | ジャンル、雰囲気、楽器、テンポ、冒頭から終わりまでの展開を説明します。歌なしにしたい場合は instrumental と記載してください。 1 文字以上 · 5000 文字以内 |
image_url | いいえ | このエンドポイントでは非対応のため、 |
料金
$0.12 / 曲
生成した楽曲ごとに 1 回、長さにかかわらず課金します。生成失敗時の課金はありません。曲単価はこのページの表示を確認してください。
ユースケース
動画の背景音楽
ハイキングのモンタージュには、つま弾くギター、軽い打楽器、穏やかな終わり方で、100 BPM の前向きなアコースティックフォークのインストゥルメンタルを依頼します。返された MP3 を映像に合わせて試聴し、編集尺に切り詰めます。
ポッドキャストのオープニング
週刊の科学ポッドキャストなら、丸みのあるシンセ音、控えめなドラム、短い導入モチーフで、好奇心を誘う 90 BPM の電子音楽を指定します。生成した曲から、冒頭の挨拶に重ねるイントロを編集できます。
ゲーム内のループ音楽
パズルのステージには、柔らかなマリンバ、伸びるパッド音、反復するセクションを備えた 80 BPM の落ち着いたアンビエント音楽を求めます。MP3 を保存して使える区間を選び、音声エディターでループの境目を確認するか、クロスフェードします。
広告のナレーションを支える音楽
生活用品の実演なら、ミュートしたギター、軽いベース、控えめな打楽器による 110 BPM の明るいインストゥルメンタルポップを依頼します。MP3 を背景音楽の候補とし、ナレーションを邪魔しないか確かめてください。
本制作前の雰囲気づくり
静かな夜の場面では、音数を抑えて始め、終盤で温かい弦楽器を加える、70 BPM の内省的なピアノ曲を指定します。最終的な劇伴を編曲する前に、音楽の方向性を検討する素材になります。
プロンプトガイドと実践のヒント
音楽の要件をまとめる
ジャンル、雰囲気、楽器名、テンポ、冒頭から終わりまでの構成を prompt に書きます。希望の長さは目安として含め、歌なしにしたい場合は instrumental と記載してください。
生成リクエストを送信する
https://api.spicyapi.ai/api/v1/jobs/createTask に Bearer 認証を付けて POST します。JSON は {"model":"google/lyria-3.5/text-to-audio","input":{"prompt":"Calm acoustic folk instrumental, 100 BPM, picked guitar, soft percussion, gentle ending; aim for 30 seconds."}} です。
完成した曲を受け取る
data.taskId を保存し、作成時の API キーで GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_ID を呼び出します。data.state が succeeded になったら、data.output.assets[0].url から MP3 を取得してください。
編集の中でタイミングを確認する
タイムラインに置く前に、曲全体の展開を聴き、実際の長さを測ります。別の音楽的な方向を試すなら prompt を調整し、終点を正確に合わせたい場合はファイルを編集してください。
テキストから音楽を作る Lyria 3.5 API
Google DeepMind の Lyria 3.5 は、文章の指示から楽曲を生成します。このテキスト音声生成エンドポイントでは、MP3 が 1 曲返ります。prompt にジャンル、雰囲気、楽器、テンポ、構成、希望尺を記載して作曲の方向を伝えます。
Google は Lyria 3.5 の発表で、音楽性、歌詞の扱い、歌声の表現を改善したと説明しています。以下のアコースティックフォークのテストでは、曲の長さと処理時間を測定しました。
音楽生成をリクエストする
google/lyria-3.5/text-to-audio に、音楽の指示を input.prompt として送ります。以下は説明用の本文で、実測に使った prompt とは別の例です。
{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Gentle acoustic folk instrumental, 100 BPM, picked guitar, warm bass and brushed percussion. Begin with guitar, add a restrained rhythm section, then close softly. Aim for 30 seconds."
}
}
- この本文を
POST https://api.spicyapi.ai/api/v1/jobs/createTaskに送ります。Authorization: Bearer YOUR_API_KEYとContent-Type: application/jsonを付けてください。 - 受理時のレスポンスから
data.taskIdを保存します。 - 作成時の API キーで
GET /api/v1/jobs/recordInfo?taskId=YOUR_TASK_IDを照会し、タスクが最終状態になるまで確認します。 succeededになったらdata.output.assets[0].urlからダウンロードします。
タスクの結果を読み取る
タスクは音楽が完成する前に受理され、ID が返ります。以下の省略したレスポンスは、仮の識別子とファイルのサンプルアドレスを使っています。
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "queued"
}
}
{
"code": 200,
"data": {
"taskId": "job_YOUR_TASK_ID",
"state": "succeeded",
"output": {
"assets": [
{"url": "https://example.com/your-track.mp3"}
]
}
}
}
完全なレスポンス構造はタスク API 資料を参照してください。取得したレコードを利用可能な楽曲と判断する前に、最終状態を確認します。
パラメーターと音楽の方向性
このエンドポイントで指定できる音楽の設定は prompt にまとめます。テンポと長さも、独立した数値フィールドではなく文章に含めてください。
| フィールド・指示 | 使い方 |
|---|---|
prompt | 音楽の指示を文章で指定します |
| ジャンルと雰囲気 | 内省的なアコースティックフォークなど、スタイルと目指す感情を伝えます |
| 楽器 | 主役の楽器と、それを支えるパートを指定します |
| テンポ | BPM または速度感を説明に含めます |
| 構成 | 導入、展開、終わり方を描写します |
| 希望尺 | 希望の長さを書き、返された尺を確認します |
| 非対応のフィールド | image_url、duration、seed、出力形式の設定は含めません |
作品に合う曲を得るために
具体的な編曲の指示があると、音楽を評価する基準が明確になります。広告用なら抑えた楽器編成を求め、実際のナレーションと重ねて聴きます。ゲーム用なら反復する一節を指定し、後からループの境目を編集します。
- 歌のない曲にしたい場合は instrumental と記載します。
- 主役の楽器と少人数の伴奏編成を選び、目指すミックスを明確にします。
- 関係のない雰囲気の単語を並べるより、盛り上がりの変化を説明します。
- テイクごとに指示の一部分を変え、対応する音楽的な違いを聴き比べます。
- 採用した MP3 は prompt と一緒に保管し、選んだテイクを残します。
アコースティックフォークの実測でわかったこと
アコースティックフォークのインストゥルメンタルを 100 BPM・30 秒として指定したところ、61.6 秒の曲が返りました。生成には約 30 秒かかり、出力は 44.1 kHz ステレオ・約 193 kbps の MP3 が 1 曲でした。
| テスト条件・測定項目 | 記録した値 |
|---|---|
| 指示の内容 | ニュートラルなアコースティックフォークのインストゥルメンタル |
| 指定テンポ | 100 BPM |
| 指定した長さ | 30 秒 |
| 実際の長さ | 61.6 秒 |
| 処理時間 | 約 30 秒 |
| 音声 | MP3、44.1 kHz ステレオ、約 193 kbps |
この 1 回の結果は、尺の指定が目安であることを示します。音楽スタイル全般の標準的な待ち時間や品質を示すものではありません。曲全体を聴いて編曲の変化を確認し、動画の正確なカットやポッドキャストの導入に同期させる前に、測定して切り詰めてください。
生成した曲ごとの料金
曲単位で課金し、長さには依存しません。指示を変えた案の予算を立てる際は、このページに表示される単価を確認してください。短い曲を依頼しても課金単位は同じです。生成に失敗した場合、曲の料金は発生しません。
制限とトラブルへの対応
専用の長さ設定がないため、尺を超えた場合は編集が必要です。リクエストに失敗したら、input に対応する prompt フィールドが入っているか確認し、返されたエラーを調べてから指示を修正して送信します。
Google は音楽用フィルターが特定のアーティストの声や著作権のある歌詞のリクエストを制限すると説明しています。音楽的な特徴を描写し、利用する権利のある文章と声を使ってください。実在の人物になりすます利用は避けます。Google のモデルカードには SynthID 透かしの説明もあります。
別の制作手順に合う関連モデルを選ぶ
編曲とおおよその尺を文章で指定し、曲をダウンロードしたい場合はこのエンドポイントを選びます。短い音楽には Clip、ストリーミングには RealTime を、リンク先の Google 資料で検討してください。
| 必要なもの | 検討する選択肢 |
|---|---|
| 編集タイムラインで使う、文章で指示した MP3 | Lyria 3.5 のテキスト音声生成 |
| 尺が 30 秒に固定された音楽クリップ | Google は Lyria 3 Clip が 30 秒のクリップを生成すると説明しています |
| 再生中に方向を調整できるインストゥルメンタル音楽 | Google は Lyria RealTime を対話的なストリーミングモデルとして紹介しています |
| 正確な切り出しや編集済みのループ | ダウンロードした曲を音声エディターで切り詰めるか、クロスフェードします |
API クイックスタート
# Generate the idempotency key once; reuse it when retrying after a lost response.
export SPICY_IDEMPOTENCY_KEY="${SPICY_IDEMPOTENCY_KEY:-$(uuidgen)}"
curl -X POST https://api.spicyapi.ai/api/v1/jobs/createTask \
-H "Authorization: Bearer $SPICY_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $SPICY_IDEMPOTENCY_KEY" \
-d '{
"model": "google/lyria-3.5/text-to-audio",
"input": {
"prompt": "Calm ambient pads with a slow rising motif"
}
}'
# Copy data.taskId from the response into TASK_ID, then poll the status.
TASK_ID="TASK_ID_FROM_RESPONSE"
curl "https://api.spicyapi.ai/api/v1/jobs/recordInfo?taskId=$TASK_ID" \
-H "Authorization: Bearer $SPICY_API_KEY"
認証、完全なスキーマ、ポーリング、エラー処理は API リファレンスを参照してください。
