google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה.
הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.
", "aboutText": "google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה. הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.", "editorialOverlay": { "copy_fields": { "about_html": "google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה.
הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.
", "short_text": "יצירת מוזיקה מטקסט, בבקשה לקטע אחד עד שמונה ובמסירת תוצאות סינכרונית." }, "copy_sha256": "d99e3847d07aaed1162ec04fbbf82459ffc892fbdaec39857855feef6b550220", "copy_source": { "locale": "he", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "8b9acfdd8322a879189092ca8c42e85f9608252a7d47c6a268980dc7cd16b64c", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "9b8741874da4a02260f417e45e744be91fd309a19f400c4336a8f5158b7a442f", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "he", "methods": [ { "html": "google/lyriaיצירת מוזיקה מטקסט, בבקשה לקטע אחד עד שמונה ובמסירת תוצאות סינכרונית.
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
google/lyria יוצר מוזיקה מהנחיה כתובה דרך /v1/music/generations. שימוש מוחשי הוא בקשת רקע אינסטרומנטלי מאופק להדגמת מוצר, תוך תיאור הכלים הבולטים וכמה מקום דרוש לקריינות. בחרו במסלול כשקטע מוזיקלי שנוצר הוא התוצאה הרצויה.
הבקשה מחייבת model ו-prompt. הבקרה n או count מקבלת קטע אחד עד שמונה, והשיטה מחזירה את תוצאת היצירה באופן סינכרוני. שמרו כל קטע שהוחזר ואת המטא-נתונים שלו בפועל. הרשומה אינה חושפת קלט שמע לייחוס, הגדרת משך או שדה קצב, ולכן אלה אינם בקרות הניתנות לבחירה עצמאית. תארו כוונה מוזיקלית בהנחיה בלי להתייחס אליה כתכונה מדודה מובטחת של הפלט.
POST /v1/music/generationstextmusic| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדה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}
מבני המתודות והמזהים מדויקים; יכולת הספק נפרדת מקבלת הבקשה לביצוע.
POST /v1/music/generationsקליפים שנמסרו × תעריף בסיס לקליפ. תעריף הייחוס לבקשה אינו מתווסף. הדוגמאות לפני התאמות החלות.
1 × 0.08 $ = 0.08 $
4 × 0.08 $ = 0.32 $
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
set -eu\n: "${AILOOT_API_KEY:?Set your Ailoot API key}"\n: "${AILOOT_PROMPT_FILE:?Set your actual UTF-8 music brief}"\nexport AILOOT_PROMPT_FILE\npython3 - <<'PY_REQUEST'\nimport json,os\nfrom pathlib import Path\np=json.loads('{"model": "google/lyria", "prompt": ""}')\nf=Path(os.environ["AILOOT_PROMPT_FILE"])\nif not f.is_file():raise SystemExit("Choose your actual UTF-8 brief")\np['prompt']=f.read_text(encoding="utf-8")\nif not p['prompt'].strip():raise SystemExit("Brief must contain text")\nPath("request.json").write_text(json.dumps(p,ensure_ascii=False))\nPY_REQUEST\ncurl --fail-with-body --silent --show-error https://api.ailoot.ai/v1/music/generations \\\n -H "Authorization: Bearer $AILOOT_API_KEY" -H 'Content-Type: application/json' \\\n --data-binary @request.json -D response-headers.txt -o result.json\nexport AILOOT_API_KEY\npython3 - <<'PY_RESULT'\nimport json, os, subprocess\nfrom pathlib import Path\nfrom urllib.parse import urljoin, urlparse\nresult=json.loads(Path("result.json").read_text(encoding="utf-8"))\nprint(json.dumps(result,ensure_ascii=False,indent=2))\nfor number,clip in enumerate(result.get("data") or []):\n u=urlparse(urljoin("https://api.ailoot.ai",clip["url"]))\n if u.scheme!="https" or not u.hostname or u.username or u.password:\n raise SystemExit("Result URL must be HTTPS without embedded credentials")\n owned=u.netloc=="api.ailoot.ai" and u.path.startswith("/v1/media/assets/") and u.path.endswith("/content")\n args=["curl","--fail-with-body","--silent","--show-error",u.geturl()]\n if owned: args += ["-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"]]\n raw=subprocess.check_output(args)\n 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"\n f=Path("music-"+str(number)+"."+ext);f.write_bytes(raw)\n print("Saved",f,clip.get("asset_id"))\n\nPY_RESULT\nקטעי אודיו שלמים בבעלותכם / קישורי 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
השתמשו בנתיבי השיטות המוצגים למעלה.