モデル

Lyria 3 Clip Preview

Markdown · JSON

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

Google /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のメソッド料金

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}/content
  • GET /v1/media/assets
  • GET /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

google/lyria-3-clip-preview

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

詳細を見る

AilootをClaude Code、OpenCode、Hermes、自分のアプリに接続しましょう。

企業とそのプロジェクト群

企業とそのプロジェクト群:数百万の顧客、毎月数十億規模の売上。

トークンを割引価格で購入。

継続利用にサブスクリプション割引。プロモコードでトークン購入が最大50%割引。

サブスクリプション
定期的なリクエストに合う割引プランを選びましょう。
最大50%のプロモコード
購入時にコードを入力すると、実施中のキャンペーンに沿って価格を再計算します。
支出を履歴で確認
各リクエストのモデル、トークン、金額が保存されます。

サブスクリプションを選ぶ · モデルの価格を見る

販売する製品に、 APIを組み込みましょう。

SaaS、アプリ、ボットをAilootの公式サービス提供条件とライセンス契約に基づいて接続できます。再販にはリセラーライセンスを申請できます。

商用アプリ
サービスの有料機能に、文章、画像、動画、音声の生成を組み込めます。
リセラーライセンス
プロジェクトの説明とアクセスの仕組みをお送りください。利用・再販条件の書面を申請できます。
サイトで契約文書を確認
接続前にサービス提供条件、ライセンス契約、データ処理ポリシーを読めます。

リセラーライセンスを申請 · サービス提供条件とライセンス契約