Lyria
Penjanaan muzik daripada teks dengan satu hingga lapan klip diminta dan penghantaran hasil segerak.
Tentang model
Huraian ini merangkumi keupayaan model. Input, output dan pilihan yang tersedia di Ailoot disenaraikan di bawah untuk kaedah yang dipilih.
google/lyria mencipta muzik daripada prompt bertulis melalui /v1/music/generations. Kegunaan konkrit ialah meminta iringan instrumental terkawal untuk demonstrasi produk, dengan menerangkan instrumen utama dan ruang yang diperlukan narasi. Pilih laluan apabila klip muzik dijana ialah hasil dikehendaki.
Permintaan memerlukan model dan prompt. Kawalan n atau count menerima satu hingga lapan klip, dan kaedah memulangkan hasil penjanaan secara segerak. Simpan setiap klip dipulangkan serta metadata sebenarnya. Entri tidak menyediakan input rujukan audio, tetapan tempoh atau medan tempo, maka ia bukan kawalan boleh dipilih secara bebas. Terangkan niat muzik dalam prompt tanpa menganggapnya sifat output diukur yang dijamin.
Ailoot · Muzik POST /v1/music/generations google/lyria
google/lyriaPengenalan
Penjanaan muzik daripada teks dengan satu hingga lapan klip diminta dan penghantaran hasil segerak.
- 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 | Lalai— |
Medanprompt | Jenisstring | KeperluanDiperlukan | Nilai & had Panjang minimum: 1 | Lalai— |
Medann | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 8 | Lalai1 |
Medancount | Jenisinteger | KeperluanPilihan | Nilai & had Minimum: 1 Maksimum: 8 Syarat: Jika n turut diberikan, bilangannya mesti sepadan | 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.08 bagi setiap klip
- Rujukan sahaja · tidak ditambah
- USD 0.08 bagi setiap permintaan
Klip yang dihantar × kadar asas setiap klip. Kadar rujukan setiap permintaan tidak ditambah. Contoh sebelum pelarasan yang berkenaan.
1 × USD 0.08 = USD 0.08
4 × USD 0.08 = USD 0.32
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 →
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", "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
Alias laluan kaedah
Gunakan laluan kaedah yang dipaparkan di atas.
ID pemanggil berkaitan
FAQ · Lyria
- Apakah input dan hasil yang tersedia?
POST /v1/music/generations·google/lyria:text→music- Apakah medan yang digunakan oleh permintaan?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Apakah had yang terpakai?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8