מודלים

Lyria

Markdown · JSON

Lyria

יצירת מוזיקה מטקסט, בבקשה לקטע אחד עד שמונה ובמסירת תוצאות סינכרונית.

על המודל

התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.

google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה.

הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.

Ailoot · מוזיקה POST /v1/music/generations google/lyria

google/lyria

Google /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

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}/content
  • GET /v1/media/assets
  • GET /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

google/lyria

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

פרטים נוספים

חברו Ailoot ל- Claude Code, OpenCode, Hermes או ליישום שלכם.

החברה ופורטפוליו הפרויקטים שלה

החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.

קנו אסימונים בהנחה.

הנחת מנוי לעבודה קבועה. קודי הנחה עד 50% על רכישת אסימונים.

מנוי
בחרו מסלול עם הנחה לבקשות הקבועות שלכם.
קוד הנחה עד 50%
הזינו קוד ברכישה. המחיר יחושב מחדש לפי המבצע הפעיל.
הוצאות בהיסטוריה
המודל, האסימונים והסכום נשמרים לכל בקשה.

בחירת מנוי · מחירי מודלים

חברו API למוצר שאתם מוכרים.

SaaS, יישומים ובוטים לפי ההצעה והסכם הרישוי של Ailoot. למכירה מחדש בקשו רישיון משווק.

יישום מסחרי
שלבו יצירת טקסט, תמונות, וידאו ושמע בתכונות בתשלום של השירות שלכם.
רישיון למכירה מחדש
שלחו תיאור פרויקט ואופן מתן גישה. בקשו תנאי שימוש ומכירה מחדש בכתב.
מסמכים באתר
ההצעה, הסכם הרישוי ומדיניות עיבוד הנתונים זמינים לפני החיבור.

בקשת רישיון למכירה מחדש · ההצעה והסכם הרישוי