Lyria 3 Clip Preview
Lyria 3 Clip Previewは、短いクリップ、ループ、プレビュー向けのGoogleの音楽モデルです。テキストや画像の着想から、48 kHzステレオの30秒の音楽を生成し、ボーカル、時間情報付きの歌詞、インストゥルメンタルの編曲に対応します。
モデルについて
この説明はモデルの機能を紹介するものです。Ailootで利用できる入力、出力、オプションは、選択したメソッドごとに以下に記載されています。
Lyria 3 Clip Previewは、短いクリップ、ループ、プレビュー向けのGoogleの音楽生成プロファイルです。テキストのプロンプトや画像による着想を受け取り、テキストと音声を返します。公開プロファイルは、ボーカル、時間情報付きの歌詞、完全なインストゥルメンタルの編曲を含む、48 kHzステレオ音声の30秒クリップを説明しています。
音楽の場面を説明する
クリップの目的と、伝えるべき雰囲気を示してください。短いオープニングテーマなら、控えめな導入と主題への明確な入りを指定できます。背景の音楽なら、映像シーンの下に必要なテンポや音の質感を示せます。ボーカルを含めるかインストゥルメンタルにするかを明記し、指示に重要な音楽要素を挙げてください。
構成はクリップに収まる規模にします。冒頭、主なフレーズ、終わり方やループ点を指定してください。言葉が重要なら、意図する歌詞の案や表現を入力し、実際に歌われた結果を確認します。音楽の指示では、ボーカル内容と編曲の指示を区別するべきです。
画像の着想と編曲
画像を入力する場合は、その画像が音楽の依頼にどのような場面や雰囲気を与えるかを説明してください。静かな風景と混雑した夜の場面は異なる方向を示しますが、求める感情的な役割は引き続きテキストで明示するべきです。返されたクリップを意図したコンセプトと比較する際は、画像をプロンプトと一緒に残してください。
ボーカル、楽器、主な音楽フレーズのバランスを確認します。ループでは終わりと始まりをつなげて聞き、プレビューでは短い時間で意図する方向を伝えられているかを確認してください。編集映像に添えるクリップは、単独で聞くだけではなく、その映像に合わせて確認するべきです。
聴いて確認する成果物を残す
実際の音声と添付テキストを、指示とともに保存してください。再生の準備やエディターへの読み込み時にはファイルのプロパティを確認し、リクエストが返した歌詞や時間情報を残します。音楽がモデルの出力です。カット、タイトル、映像のトランジション、最終的な制作ミックスは、確認済みのその素材に合わせて組み立てられます。
この正確なClip Previewプロファイルは、コンパクトな音楽成果物に適しています。長い楽曲を計画する際は短尺向けの役割を区別し、フレーズ全体、歌われた言葉、終わり方を聞いて返されたクリップを選んでください。
Ailoot · 音楽 POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewはじめに
Lyria 3 Clip Previewは、短いクリップ、ループ、プレビュー向けのGoogleの音楽モデルです。テキストや画像の着想から、48 kHzステレオの30秒の音楽を生成し、ボーカル、時間情報付きの歌詞、インストゥルメンタルの編曲に対応します。
- 対応する入力
- テキスト
- 結果
- music
Ailootで利用可能 · 入力とメソッド
Ailoot · 音楽 POST /v1/music/generations
- 入力の種類
text- 出力の種類
music- 出力形式
- 完全な所有音声クリップ/JSONリンク
| フィールド | 種類 | 要件 | 値と制限 | デフォルト |
|---|---|---|---|---|
フィールドmodel | 種類string | 要件必須 | 値と制限 google/lyria-3-clip-preview | デフォルト— |
フィールドprompt | 種類string | 要件必須 | 値と制限 最小の長さ: 1 | デフォルト— |
入力素材の組み合わせ
text_to_music · 必須: prompt
メソッドのパラメータとライフサイクル
| パラメータ | 仕様 |
|---|---|
パラメータmaterial_types | 仕様text |
パラメータrequired | 仕様null |
パラメータoptional_controls | 仕様null |
ライフサイクル: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · 実際に返された task_id またはメディアライブラリのレコード
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
メソッドの形式とIDは正確に記載しています。供給元の対応能力とリクエストの受け入れは別です。
料金
Ailootのメソッド料金
POST /v1/music/generations- 出力
- $0.04 クリップあたり
- 参考のみ・加算なし
- $0.04 リクエストあたり
配信されたクリップ数 × クリップの基本料金。リクエスト単位の参考料金は加算されません。例は適用調整前の金額です。
1 × $0.04 = $0.04
Ailootはリクエスト前に見積額を確保します。結果の取得後、実測使用量に基づいて最終料金を精算します。ストリーミング時の精算には最終の使用量記録を使用します。金額の確保と精算の仕組み →
参考料金の詳細
モデル単位の参照料金表は、メソッド選択、見積もり、課金を変更しません。実際の課金には、選択したAilootメソッドの料金を適用します。
モデルの参照料金表
設定別の価格
| 設定 | サービス階層 | コンテキストの条件 | 料金 |
|---|---|---|---|
| 設定Ultra | サービス階層standard | コンテキストの条件{} | 料金 出力 · 音楽 $0.08 曲あたり |
リクエスト例
Ailoot · 音楽
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"
export AILOOT_PROMPT_FILE
python3 - <<'PY_REQUEST'
import json,os
from pathlib import Path
p=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')
f=Path(os.environ["AILOOT_PROMPT_FILE"])
if not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")
p['prompt']=f.read_text(encoding="utf-8")
if not p['prompt'].strip():raise SystemExit("Brief must contain text")
Path("request.json").write_text(json.dumps(p,ensure_ascii=False))
PY_REQUEST
curl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \
-H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \
--data-binary @request.json -D response-headers.txt -o result.json
export AILOOT_API_KEY
python3 - <<'PY_RESULT'
import json, os, subprocess
from pathlib import Path
from urllib.parse import urljoin, urlparse
result=json.loads(Path("result.json").read_text(encoding="utf-8"))
print(json.dumps(result,ensure_ascii=False,indent=2))
for number,clip in enumerate(result.get("data") or []):
u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))
if u.scheme!="https" or not u.hostname or u.username or u.password:
raise SystemExit("Result URL must be HTTPS without embedded credentials")
owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")
args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]
if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]
raw=subprocess.check_output(args)
ext="wav" if raw.startswith(b"RIFF") and raw[8:12]==b"WAVE" else "flac" if raw.startswith(b"fLaC") else "ogg" if raw.startswith(b"OggS") else "mp3" if raw.startswith(b"ID3") or raw[:1]==b"\xff" else "bin"
f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)
print("Saved",f,clip.get("asset_id"))
PY_RESULT
結果を受け取って保存
Ailoot · 音楽
完全な所有音声クリップ/JSONリンク
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
完了した結果をすべて保存
返された完全なレスポンス、ファイル、コンテンツ部分をすべて保存してください。
返されたクリップをすべて保存/取得し、実際のID、MIME、メタデータを保持してください。このメソッドは同期式です。別途Ailootの音楽生成用ポーリングURLを導入するものではありません。
元のレスポンスを確認する場合
音楽の結果に確認が必要な場合は、元のoperation_id/X-Client-Request-IDと、返されたクリップ情報を保持してください。実際のtask_idまたはasset_idを使い、メディアライブラリから既存の所有クリップを復元してください。音楽リクエストを再送信したり、operation_idから生成用ポーリングURLを組み立てたりしないでください。
レスポンスのフィールド
| フィールド | 種類 |
|---|---|
フィールドmodel | 種類string |
フィールドresponse_id | 種類string |
フィールドdata[] | 種類owned clip record |
エラーと次の手順
| レスポンス | 条件 | 次の手順 |
|---|---|---|
レスポンス400 · invalid_request_error | 条件必須フィールド、素材の表現形式、またはパラメーター値が不正です | 次の手順新しい生成リクエストを送る前に、指定されたフィールドを修正してください。 |
レスポンスserver_error | 条件返されたレスポンスは、操作または結果の確認が必要であることを示しています | 次の手順最初に返された操作/タスク ID、リクエストヘッダー、レスポンスを保存し、その元の操作に対してサポートされている読み取りを継続してください。作成リクエストを再送しないでください。 |
エイリアス
モデルのエイリアス
Ailoot google/lyria-3-clip-preview
メソッドパスのエイリアス
上記に表示されたメソッドパスを使用してください。
関連する呼び出し用ID
FAQ · Lyria 3 Clip Preview
- 利用できる入力と結果は何ですか?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- リクエストはどの項目を使用しますか?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt