Lyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂生成規格。它接受文字提示或圖片靈感，回傳文字與音訊。公開規格描述 30 秒、48 kHz 立體聲片段，包含人聲、帶時間資訊的歌詞及完整器樂編曲。
請指出片段用途與應傳達的情緒。簡短開場主題可指定克制的引子與明確進入主段的時刻；背景配樂可描述視覺場景下方所需的速度與質地。請說明結果應有人聲或純器樂，並指出簡述中重要的音樂元素。
請讓結構符合片段大小。指出開頭、主樂句及結尾或循環點。若歌詞重要，請提供預期歌詞構想或措辭，並檢視實際演唱結果。音樂簡述應將人聲內容與編曲指示區分。
提供圖片時，請解釋它對音樂請求帶來哪種場景或情緒。平靜風景與擁擠夜景指向不同方向，但預期情感角色仍應在文字明示。將回傳片段與預期概念比較時，請把圖片和提示一起保留。
請審查人聲、樂器與主樂句之間的平衡。循環片段請將結尾與開頭接起來聆聽；預覽片段請檢查短時長是否傳達預期方向。搭配剪輯的片段，應與該剪輯一起審查，不應只單獨聆聽。
請將實際音訊及附隨文字和簡述一起儲存。準備播放或匯入編輯器時，請檢查檔案屬性，並保留請求回傳的任何歌詞或時間資訊。音樂是模型輸出；剪接、標題、視覺轉場及最終製作混音，可圍繞這份已檢視素材安排。
這個確切 Clip Preview 規格適合精簡音樂交付物。規劃較長作品時，請區分其短篇角色，並依完整樂句、人聲措辭及結尾的聆聽結果選擇回傳片段。
", "aboutText": "Lyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂生成規格。它接受文字提示或圖片靈感，回傳文字與音訊。公開規格描述 30 秒、48 kHz 立體聲片段，包含人聲、帶時間資訊的歌詞及完整器樂編曲。\n\n### 描述音樂時刻\n\n請指出片段用途與應傳達的情緒。簡短開場主題可指定克制的引子與明確進入主段的時刻；背景配樂可描述視覺場景下方所需的速度與質地。請說明結果應有人聲或純器樂，並指出簡述中重要的音樂元素。\n\n請讓結構符合片段大小。指出開頭、主樂句及結尾或循環點。若歌詞重要，請提供預期歌詞構想或措辭，並檢視實際演唱結果。音樂簡述應將人聲內容與編曲指示區分。\n\n### 圖片靈感與編曲\n\n提供圖片時，請解釋它對音樂請求帶來哪種場景或情緒。平靜風景與擁擠夜景指向不同方向，但預期情感角色仍應在文字明示。將回傳片段與預期概念比較時，請把圖片和提示一起保留。\n\n請審查人聲、樂器與主樂句之間的平衡。循環片段請將結尾與開頭接起來聆聽；預覽片段請檢查短時長是否傳達預期方向。搭配剪輯的片段，應與該剪輯一起審查，不應只單獨聆聽。\n\n### 保留聆聽產物\n\n請將實際音訊及附隨文字和簡述一起儲存。準備播放或匯入編輯器時，請檢查檔案屬性，並保留請求回傳的任何歌詞或時間資訊。音樂是模型輸出；剪接、標題、視覺轉場及最終製作混音，可圍繞這份已檢視素材安排。\n\n這個確切 Clip Preview 規格適合精簡音樂交付物。規劃較長作品時，請區分其短篇角色，並依完整樂句、人聲措辭及結尾的聆聽結果選擇回傳片段。", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "95b97feea81749810c6ecd56d062fe6ddcc99271de3a4a2582d56424f69b2934", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "zh-hant-tw", "methods": [ { "html": "google/lyria-3-clip-previewLyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂模型。它以文字或圖片作為靈感，產生 30 秒、48 kHz 立體聲音樂，支援人聲、帶時間資訊的歌詞及器樂編曲。
此說明介紹模型的能力。Ailoot 可用的輸入、輸出與選項，依所選方法列於下方。
Lyria 3 Clip Preview 是 Google 用於短片段、循環與預覽的音樂生成規格。它接受文字提示或圖片靈感，回傳文字與音訊。公開規格描述 30 秒、48 kHz 立體聲片段，包含人聲、帶時間資訊的歌詞及完整器樂編曲。
請指出片段用途與應傳達的情緒。簡短開場主題可指定克制的引子與明確進入主段的時刻；背景配樂可描述視覺場景下方所需的速度與質地。請說明結果應有人聲或純器樂，並指出簡述中重要的音樂元素。
請讓結構符合片段大小。指出開頭、主樂句及結尾或循環點。若歌詞重要，請提供預期歌詞構想或措辭，並檢視實際演唱結果。音樂簡述應將人聲內容與編曲指示區分。
提供圖片時，請解釋它對音樂請求帶來哪種場景或情緒。平靜風景與擁擠夜景指向不同方向，但預期情感角色仍應在文字明示。將回傳片段與預期概念比較時，請把圖片和提示一起保留。
請審查人聲、樂器與主樂句之間的平衡。循環片段請將結尾與開頭接起來聆聽；預覽片段請檢查短時長是否傳達預期方向。搭配剪輯的片段，應與該剪輯一起審查，不應只單獨聆聽。
請將實際音訊及附隨文字和簡述一起儲存。準備播放或匯入編輯器時，請檢查檔案屬性，並保留請求回傳的任何歌詞或時間資訊。音樂是模型輸出；剪接、標題、視覺轉場及最終製作混音，可圍繞這份已檢視素材安排。
這個確切 Clip Preview 規格適合精簡音樂交付物。規劃較長作品時，請區分其短篇角色，並依完整樂句、人聲措辭及結尾的聆聽結果選擇回傳片段。
POST /v1/music/generationstextmusic| 欄位 | 類型 | 要求 | 值與限制 | 預設值 |
|---|---|---|---|---|
欄位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 均為精確值；供應商能力與准入狀態分開。
POST /v1/music/generations已交付片段數 × 每段基本費率。每次請求的參考費率不會另加。範例為適用調整前的金額。
1 × US$0.04 = US$0.04
Ailoot 會在請求前預留估算金額。取得結果後，依實測用量結算最終費用。串流結算採用最終用量紀錄。預留金額與結算的運作方式 →
模型層級的參考費率表不會變更方法選擇、報價或費用。實際計費採用所選 Ailoot 方法的費率。
| 設定 | 服務層級 | 上下文條件 | 費用 |
|---|---|---|---|
| 設定Ultra | 服務層級standard | 上下文條件{} | 費用 輸出 · 音樂 US$0.08 每首歌曲 |
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria-3-clip-preview", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n 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"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\n完整的自有音訊片段／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
請使用上方列出的 API 方法路徑。