Lyria
Мәтіннен музыка жасау: бірден сегізге дейін клип сұрау және нәтижені синхронды алу.
Модель туралы
Бұл сипаттама модель мүмкіндіктерін қамтиды. Ailoot жүйесінде таңдалған әдіс үшін қолжетімді кіріс, шығыс және параметрлер төменде берілген.
google/lyria /v1/music/generations арқылы жазбаша промпттан музыка жасайды. Өнім демонстрациясына ұстамды аспаптық фон сұрап, алдыңғы аспаптарды және диктор дауысына қанша орын керек екенін сипаттауға болады. Қажетті нәтиже жасалған музыкалық клип болса таңдаңыз.
model мен prompt міндетті. n не count бірден сегізге дейін клип қабылдайды, әдіс генерация нәтижесін синхронды қайтарады. Әр клип пен нақты метадерегін сақтаңыз. Audio-reference кірісі, duration баптауы не tempo өрісі жоқ, сондықтан олар бөлек таңдалатын басқарулар емес. Музыкалық ойды промптта беріңіз, бірақ оны шығыстың кепілді өлшенген қасиеті деп санамаңыз.
Ailoot · Музыка POST /v1/music/generations google/lyria
google/lyriaБастау
Мәтіннен музыка жасау: бірден сегізге дейін клип сұрау және нәтижені синхронды алу.
- Қабылданатын кіріс деректері
- Мәтін
- Нәтижелер
- music
Ailoot жүйесінде қолжетімді · кіріс деректері мен әдістер
Ailoot · Музыка POST /v1/music/generations
- Кіріс
text- Шығыс
music- Шығыс пішімі
- иелігіңіздегі толық аудиоүзінділер / JSON сілтемелері
| Өріс | Түрі | Талап | Мәндер мен шектеулер | Әдепкі |
|---|---|---|---|---|
Өрісmodel | Түріstring | ТалапМіндетті | Мәндер мен шектеулер google/lyria | Әдепкі— |
Өрісprompt | Түріstring | ТалапМіндетті | Мәндер мен шектеулер Ең аз ұзындық: 1 | Әдепкі— |
Өрісn | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 8 | Әдепкі1 |
Өрісcount | Түріinteger | ТалапМіндетті емес | Мәндер мен шектеулер Ең азы: 1 Ең көбі: 8 Шарттар: n өрісі де берілсе, сан сәйкес келуі керек | Әдепкі— |
Кіріс материалдарының үйлесімдері
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 әдістерінің мөлшерлемелері
POST /v1/music/generations- Шығыс
- 0,08 $ клип үшін
- Тек анықтама · қосылмайды
- 0,08 $ әр сұрау үшін
Жеткізілген клиптер × әр клиптің базалық тарифі. Сұрау үшін анықтамалық тариф қосылмайды. Мысалдар қолданылатын түзетулерге дейін берілген.
1 × 0,08 $ = 0,08 $
4 × 0,08 $ = 0,32 $
Ailoot сұрау алдында болжамды соманы резервтейді. Нәтижеден кейін өлшенген пайдалану көлемі бойынша қорытынды төлемді шегереді. Ағындық жауап үшін төлем соңғы пайдалану жазбасы негізінде шегеріледі. Резервтеу мен төлемді есептеу тәртібі →
Сұрау мысалдары
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", "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}/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
Әдіс жолдарының балама атаулары
Жоғарыда көрсетілген әдіс жолдарын пайдаланыңыз.
Шақыруға арналған байланысты ID
FAQ · Lyria
- Қандай кіріс деректері мен нәтижелер қолжетімді?
POST /v1/music/generations·google/lyria:text→music- Сұрау қандай өрістерді пайдаланады?
POST /v1/music/generations·google/lyria:model,prompt,n,count- Қандай шектеулер қолданылады?
POST /v1/music/generations·google/lyria:n.minimum:1;n.maximum:8;count.minimum:1;count.maximum:8