Lyria 3 Clip Preview
Lyria 3 Clip Preview ialah model muzik Google untuk klip pendek, loop dan pratonton. Ia menerima inspirasi teks atau imej dan menghasilkan muzik 30 saat dengan audio stereo 48 kHz, menyokong vokal, lirik bermasa serta susunan instrumental.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
Lyria 3 Clip Preview ialah profil penjanaan muzik Google untuk klip pendek, loop dan pratonton. Ia menerima prompt teks atau inspirasi imej dan mengembalikan teks serta audio. Profil yang diterbitkan menerangkan klip 30 saat dengan audio stereo 48 kHz, termasuk vokal, lirik bermasa dan susunan instrumental lengkap.
Terangkan detik muzik
Nyatakan tujuan klip dan suasana yang perlu dibawanya. Tema pembukaan pendek boleh menetapkan pengenalan terkawal dan kemunculan tema yang jelas; muzik latar boleh mengenal pasti rentak serta tekstur yang diperlukan di bawah adegan visual. Nyatakan sama ada hasil patut menampilkan vokal atau instrumental dan namakan unsur muzik yang penting kepada taklimat.
Pastikan struktur cukup kecil untuk klip. Kenal pasti pembukaan, frasa utama dan pengakhiran atau titik loop. Jika kata-kata penting, berikan idea atau ungkapan lirik yang dimaksudkan dan periksa hasil nyanyian sebenar. Taklimat muzik perlu membezakan kandungan vokal daripada arahan tentang susunan.
Inspirasi imej dan susunan
Apabila membekalkan imej, jelaskan adegan atau suasana yang disumbangkannya kepada permintaan muzik. Landskap tenang dan adegan malam sesak mencadangkan arah berbeza, tetapi peranan emosi yang dikehendaki masih perlu dinyatakan dengan jelas dalam teks. Simpan imej bersama prompt apabila membandingkan klip yang dikembalikan dengan konsep sasaran.
Semak keseimbangan antara vokal, instrumen dan frasa muzik utama. Untuk loop, dengar penghujung dan permulaan bersama-sama; untuk pratonton, periksa sama ada tempoh pendek menyampaikan arah yang dimaksudkan. Klip yang mengiringi suntingan perlu disemak bersama suntingan itu, bukannya hanya secara berasingan.
Simpan artifak untuk didengar
Simpan audio sebenar dan sebarang teks iringan bersama taklimat. Periksa sifat fail apabila menyediakan main balik atau mengimportnya ke editor dan simpan sebarang maklumat lirik atau pemasaan yang dikembalikan permintaan. Muzik ialah output model; potongan, tajuk, peralihan visual dan campuran produksi akhir boleh disusun berdasarkan aset yang telah diperiksa itu.
Profil Clip Preview tepat ini sesuai untuk hasil muzik kompak. Asingkan peranan format pendeknya ketika merancang komposisi lebih panjang dan pilih klip yang dikembalikan dengan mendengar seluruh frasa, ungkapan vokal dan pengakhiran.
Ailoot · Muzik POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewPengenalan
Lyria 3 Clip Preview ialah model muzik Google untuk klip pendek, loop dan pratonton. Ia menerima inspirasi teks atau imej dan menghasilkan muzik 30 saat dengan audio stereo 48 kHz, menyokong vokal, lirik bermasa serta susunan instrumental.
- Input yang diterima
- Teks
- Hasil
- music
Tersedia di Ailoot · input & kaedah
Ailoot · Muzik POST /v1/music/generations
- Input
text- Output
music- Format output
- klip audio lengkap milik anda / pautan JSON
| Medan | Jenis | Keperluan | Nilai & had | Lalai |
|---|---|---|---|---|
Medanmodel | Jenisstring | KeperluanDiperlukan | Nilai & had google/lyria-3-clip-preview | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Gabungan bahan input
text_to_music · Diperlukan: prompt
Parameter kaedah dan kitar hayat
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Kitar hayat: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id sebenar yang dikembalikan atau rekod pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur kaedah dan ID adalah tepat; keupayaan pembekal berasingan daripada penerimaan permintaan.
Pelan harga
Kadar kaedah Ailoot
POST /v1/music/generations- Output
- USD 0.04 bagi setiap klip
- Rujukan sahaja · tidak ditambah
- USD 0.04 bagi setiap permintaan
Klip yang dihantar × kadar asas setiap klip. Kadar rujukan setiap permintaan tidak ditambah. Contoh sebelum pelarasan yang berkenaan.
1 × USD 0.04 = USD 0.04
Ailoot merizabkan anggaran amaun sebelum permintaan. Selepas hasil diterima, caj akhir diselesaikan berdasarkan penggunaan terukur. Penyelesaian caj penstriman menggunakan rekod penggunaan akhir. Cara rizab dan penyelesaian caj berfungsi →
Butiran tarif rujukan
Jadual rujukan peringkat model tidak mengubah pemilihan kaedah, sebut harga atau caj. Caj aktif menggunakan kadar kaedah Ailoot yang dipilih.
Jadual rujukan model
Harga mengikut konfigurasi
| Konfigurasi | Peringkat perkhidmatan | Syarat konteks | Caj |
|---|---|---|---|
| KonfigurasiUltra | Peringkat perkhidmatanstandard | Syarat konteks{} | Caj Output · muzik USD 0.08 bagi setiap lagu |
Contoh permintaan
Ailoot · Muzik
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
Terima dan simpan hasil
Ailoot · Muzik
klip audio lengkap milik anda / pautan JSON
GET /v1/media/tasks/{task_id}GET /v1/media/assets/{asset_id}/contentGET /v1/media/assetsGET /v1/media/assets/{asset_id}
Simpan semua hasil yang selesai
Simpan setiap respons lengkap, fail dan bahagian kandungan yang dikembalikan.
Simpan/dapatkan setiap klip yang dikembalikan dan kekalkan ID, MIME serta metadata sebenar. Kaedah ini segerak; tiada URL semakan berkala berasingan untuk penjanaan muzik Ailoot diperkenalkan.
Jika respons asal perlu disemak
Jika hasil muzik memerlukan semakan, simpan operation_id/X-Client-Request-ID asal dan maklumat klip yang dikembalikan. Pulihkan klip sedia ada milik anda melalui pustaka media menggunakan nilai task_id atau asset_id sebenar. Jangan hantar semula permintaan muzik atau membina URL semakan berkala penjanaan daripada operation_id.
Medan respons
| Medan | Jenis |
|---|---|
Medanmodel | Jenisstring |
Medanresponse_id | Jenisstring |
Medandata[] | Jenisowned clip record |
Ralat dan langkah seterusnya
| Respons | Syarat | Langkah seterusnya |
|---|---|---|
Respons400 · invalid_request_error | SyaratMedan wajib, perwakilan bahan atau nilai parameter tidak sah | Langkah seterusnyaBetulkan medan yang ditunjukkan sebelum permintaan penciptaan baharu. |
Responsserver_error | SyaratRespons yang dikembalikan menyatakan bahawa operasi atau hasil memerlukan semakan | Langkah seterusnyaSimpan ID operasi/tugas asal yang dikembalikan, pengepala permintaan dan respons; teruskan pembacaan yang disokong bagi operasi asal tersebut. Jangan hantar semula permintaan penciptaan. |
Alias
Alias model
Ailoot google/lyria-3-clip-preview
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Lyria 3 Clip Preview
- Apakah input dan hasil yang tersedia?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- Apakah medan yang digunakan oleh permintaan?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt