模型

Lyria 3 Clip Preview

Markdown · JSON

Lyria 3 Clip Preview

Lyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂模型。它以文字或圖片作為靈感,產生 30 秒、48 kHz 立體聲音樂,支援人聲、帶時間資訊的歌詞及器樂編曲。

關於模型

此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項,依所選方法列於下方。

Lyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂生成規格。它接受文字提示或圖片靈感,回傳文字與音訊。公開規格描述 30 秒、48 kHz 立體聲片段,包含人聲、帶時間資訊的歌詞及完整器樂編曲。

描述音樂時刻

請指出片段用途與應傳達的情緒。簡短開場主題可指定克制的引子與明確進入主段的時刻;背景配樂可描述視覺場景下方所需的速度與質地。請說明結果應有人聲或純器樂,並指出簡述中重要的音樂元素。

請讓結構符合片段大小。指出開頭、主樂句及結尾或循環點。若歌詞重要,請提供預期歌詞構想或措辭,並檢視實際演唱結果。音樂簡述應將人聲內容與編曲指示區分。

圖片靈感與編曲

提供圖片時,請解釋它對音樂請求帶來哪種場景或情緒。平靜風景與擁擠夜景指向不同方向,但預期情感角色仍應在文字明示。將回傳片段與預期概念比較時,請把圖片和提示一起保留。

請審查人聲、樂器與主樂句之間的平衡。循環片段請將結尾與開頭接起來聆聽;預覽片段請檢查短時長是否傳達預期方向。搭配剪輯的片段,應與該剪輯一起審查,不應只單獨聆聽。

保留聆聽產物

請將實際音訊及附隨文字和簡述一起儲存。準備播放或匯入編輯器時,請檢查檔案屬性,並保留請求回傳的任何歌詞或時間資訊。音樂是模型輸出;剪接、標題、視覺轉場及最終製作混音,可圍繞這份已檢視素材安排。

這個確切 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 用於短片段、循環與預覽的音樂模型。它以文字或圖片作為靈感,產生 30 秒、48 kHz 立體聲音樂,支援人聲、帶時間資訊的歌詞及器樂編曲。

接受的輸入
文字
結果
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
輸出
US$0.04 每個片段
僅供參考・不另加
US$0.04 每次請求

已交付片段數 × 每段基本費率。每次請求的參考費率不會另加。範例為適用調整前的金額。

1 × US$0.04 = US$0.04

Ailoot 會在請求前預留估算金額。取得結果後,依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →

參考費率詳情

模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。

模型參考費率表

各設定的價格

設定服務層級上下文條件費用
設定Ultra服務層級standard上下文條件{}費用
輸出 · 音樂 US$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

方法路徑別名

請使用上方列出的 API 方法路徑。

相關呼叫用 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 或自己的應用程式。

公司及其專案組合

公司及其專案組合:數百萬客戶,每月銷售額達數十億。

優惠購買 token。

訂閱優惠適合持續工作,折扣碼購買 token 最高可折 50%。

訂閱
為定期請求選擇優惠方案。
最高 50% 折扣碼
購買時輸入代碼,價格依活動重算。
歷史中的費用
每次請求保存模型、token 與金額。

選擇訂閱 · 查看模型價格

將 API 加入 你銷售的產品。

依 Ailoot 正式服務條款與授權合約串接 SaaS、應用程式與機器人;轉售請申請經銷授權。

商用應用程式
在付費功能加入文字、圖片、影片與聲音生成。
經銷授權
提供專案說明與存取方式,要求書面使用和轉售條件。
網站文件
串接前可閱讀正式服務條款、授權合約與資料處理政策。

申請經銷授權 · 正式服務條款與授權合約