Lyria
יצירת מוזיקה מטקסט, בבקשה לקטע אחד עד שמונה ובמסירת תוצאות סינכרונית.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה.
הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.
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, הערך של count חייב להתאים לו | ברירת מחדל— |
שילובים של חומרי קלט
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}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
תעריפים
תעריפי שיטות 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}
שמירת כל התוצאות שהושלמו
שמרו כל תגובה מלאה, קובץ ומקטע תוכן שהוחזרו.
יש לשמור או לאחזר כל קטע שהוחזר ולשמר את המזהה, סוג ה־MIME והמטא־נתונים בפועל. השיטה סינכרונית; לא מתווספת כתובת מעקב נפרדת ליצירת מוזיקה ב־Ailoot.
כשצריך לבדוק את התגובה המקורית
אם תוצאת מוזיקה דורשת בדיקה, יש לשמור את operation_id/X-Client-Request-ID המקוריים ואת פרטי הקטעים שהוחזרו. יש לשחזר קטעים קיימים שבבעלותכם דרך ספריית המדיה באמצעות ערכי task_id או asset_id ממשיים. אין לשלוח שוב את בקשת המוזיקה או לבנות כתובת URL למעקב אחר יצירה מתוך operation_id.
שדות התגובה
| שדה | סוג |
|---|---|
שדהmodel | סוגstring |
שדהresponse_id | סוגstring |
שדהdata[] | סוגowned clip record |
שגיאות והשלבים הבאים
| תגובה | תנאי | השלב הבא |
|---|---|---|
תגובה400 · invalid_request_error | תנאישדות נדרשים, ייצוג חומר או ערך פרמטר שאינם תקינים | השלב הבאתקנו את השדות שצוינו לפני בקשת יצירה חדשה. |
תגובהserver_error | תנאיהתשובה שהוחזרה מציינת שהפעולה או התוצאה דורשת בדיקה | השלב הבאשמרו את מזהה הפעולה/המשימה המקורי שהוחזר, את כותרות הבקשה ואת התשובה; המשיכו לבצע פעולות קריאה נתמכות של אותה פעולה מקורית. אל תשלחו שוב את בקשת היצירה. |
כינויים
כינויים למודל
Ailoot google/lyria
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
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