Lyria
Generasi musik dari teks dengan permintaan satu hingga delapan klip dan pengiriman hasil sinkron.
Tentang model
Deskripsi ini mencakup kemampuan model. Masukan, keluaran, dan opsi yang tersedia di Ailoot tercantum di bawah untuk metode yang dipilih.
google/lyria membuat musik dari prompt tertulis melalui /v1/music/generations. Contoh konkret adalah meminta musik instrumental latar yang tenang untuk demonstrasi produk, dengan menjelaskan instrumen utama dan ruang yang diperlukan narasi. Pilih rute ini ketika hasil yang diinginkan adalah klip musik generasi.
Permintaan memerlukan model dan prompt. Kontrol n atau count menerima satu hingga delapan klip, dan metode mengembalikan hasil generasi secara sinkron. Simpan setiap klip yang dikembalikan beserta metadata aktualnya. Entri tidak menyediakan input referensi audio, pengaturan durasi, atau field tempo, sehingga ketiganya bukan kontrol yang dapat dipilih independen. Jelaskan maksud musikal dalam prompt tanpa menganggapnya sebagai sifat output terukur yang dijamin.
Ailoot · Musik POST /v1/music/generations google/lyria
google/lyriaMulai
Generasi musik dari teks dengan permintaan satu hingga delapan klip dan pengiriman hasil sinkron.
- Masukan yang diterima
- Teks
- Hasil
- music
Tersedia di Ailoot · masukan & metode
Ailoot · Musik POST /v1/music/generations
- Masukan
text- Keluaran
music- Format keluaran
- klip audio lengkap milik Ailoot / tautan JSON
| Kolom | Jenis | Persyaratan | Nilai & batasan | Bawaan |
|---|---|---|---|---|
Kolommodel | Jenisstring | PersyaratanWajib | Nilai & batasan google/lyria | Bawaan— |
Kolomprompt | Jenisstring | PersyaratanWajib | Nilai & batasan Panjang minimum: 1 | Bawaan— |
Kolomn | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 8 | Bawaan1 |
Kolomcount | Jenisinteger | PersyaratanOpsional | Nilai & batasan Minimum: 1 Maksimum: 8 Kondisi: Jika n juga diberikan, jumlahnya harus sesuai | Bawaan— |
Kombinasi bahan masukan
text_to_music · Wajib: prompt
Parameter metode dan siklus hidup
| Parameter | Kontrak |
|---|---|
Parametermaterial_types | Kontraktext |
Parameterrequired | Kontraknull |
Parameteroptional_controls | Kontraknull |
Siklus hidup: synchronous_result_then_owned_library
GET /v1/media/tasks/{task_id} · task_id aktual yang dikembalikan atau catatan pustaka media
GET /v1/media/assets/{asset_id}/content
GET /v1/media/assets
GET /v1/media/assets/{asset_id}
Struktur metode dan ID bersifat eksak; kemampuan pemasok terpisah dari penerimaan permintaan.
Paket
Tarif metode Ailoot
POST /v1/music/generations- Keluaran
- US$0,08 per klip
- Referensi saja · tidak ditambahkan
- US$0,08 per permintaan
Klip yang dikirim × tarif dasar per klip. Tarif referensi per permintaan tidak ditambahkan. Contoh sebelum penyesuaian yang berlaku.
1 × US$0,08 = US$0,08
4 × US$0,08 = US$0,32
Ailoot mencadangkan perkiraan dana sebelum permintaan. Setelah hasil diterima, tagihan akhir diselesaikan berdasarkan penggunaan yang terukur. Penyelesaian tagihan streaming menggunakan catatan penggunaan akhir. Cara kerja cadangan dan penyelesaian tagihan →
Contoh permintaan
Ailoot · Musik
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 · Musik
klip audio lengkap milik Ailoot / tautan 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, berkas, dan bagian konten yang dikembalikan.
Simpan/ambil setiap klip yang dikembalikan dan pertahankan ID, MIME, serta metadata aktual. Metode ini sinkron; tidak ada URL pemeriksaan berkala terpisah yang ditambahkan untuk pembuatan musik Ailoot.
Jika respons asli perlu diperiksa
Jika hasil musik memerlukan pemeriksaan, simpan operation_id/X-Client-Request-ID awal dan informasi klip yang dikembalikan. Pulihkan klip milik Ailoot yang sudah ada melalui pustaka media menggunakan nilai task_id atau asset_id aktual. Jangan kirim ulang permintaan musik atau membentuk URL pemeriksaan berkala pembuatan dari operation_id.
Kolom respons
| Kolom | Jenis |
|---|---|
Kolommodel | Jenisstring |
Kolomresponse_id | Jenisstring |
Kolomdata[] | Jenisowned clip record |
Kesalahan dan langkah berikutnya
| Respons | Kondisi | Langkah berikutnya |
|---|---|---|
Respons400 · invalid_request_error | KondisiBidang wajib, representasi materi, atau nilai parameter tidak valid | Langkah berikutnyaPerbaiki bidang yang ditunjukkan sebelum permintaan pembuatan baru. |
Responsserver_error | KondisiRespons yang dikembalikan menyatakan bahwa operasi atau hasil perlu diperiksa | Langkah berikutnyaSimpan ID operasi/tugas asli yang dikembalikan, header permintaan, dan respons; lanjutkan pembacaan yang didukung untuk operasi asli tersebut. Jangan kirim ulang permintaan pembuatan. |
Alias
Alias model
Ailoot google/lyria
Alias jalur metode
Gunakan jalur metode yang ditampilkan di atas.
ID pemanggil terkait
FAQ · Lyria
- Input dan hasil apa yang tersedia?
POST /v1/music/generations·google/lyria:text→music- Kolom apa yang digunakan permintaan?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Batasan apa yang berlaku?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8