Lyria 3 Clip Preview
Lyria 3 Clip Preview הוא מודל המוזיקה של Google לקליפים קצרים, לולאות וקטעי תצוגה מקדימה. הוא מקבל השראה מטקסט או מתמונה ומפיק מוזיקה באורך 30 שניות עם אודיו סטריאו ב־48 kHz, ותומך בשירה, במילות שיר מתוזמנות ובעיבודים אינסטרומנטליים.
על המודל
התיאור הזה מציג את יכולות המודל. הקלט, הפלט והאפשרויות הזמינים ב-Ailoot מפורטים בהמשך לפי השיטה שנבחרה.
Lyria 3 Clip Preview הוא פרופיל יצירת המוזיקה של Google לקליפים קצרים, לולאות וקטעי תצוגה מקדימה. הוא מקבל הנחיית טקסט או תמונה להשראה ומחזיר טקסט ואודיו. הפרופיל המפורסם מתאר קליפים באורך 30 שניות עם אודיו סטריאו ב־48 kHz, כולל שירה, מילות שיר מתוזמנות ועיבודים אינסטרומנטליים מלאים.
תארו את הרגע המוזיקלי
ציינו את מטרת הקליפ ואת האווירה שהוא צריך לשאת. נעימת פתיחה קצרה יכולה לפרט מבוא מאופק והגעה ברורה לחלק המרכזי; קטע רקע יכול להגדיר את הקצב והמרקם הדרושים מתחת לסצנה חזותית. ציינו אם התוצאה צריכה לכלול שירה או להיות אינסטרומנטלית, ותנו שמות למרכיבים המוזיקליים החשובים לבריף.
שמרו על מבנה קטן דיו לקליפ. הגדירו את הפתיחה, את המשפט המוזיקלי המרכזי ואת הסיום או נקודת הלולאה. אם המילים חשובות, ספקו את הרעיון הלירי או הניסוח המיועדים ובדקו את התוצאה המושרת בפועל. הבריף המוזיקלי צריך להבחין בין התוכן המושר לבין הוראות הנוגעות לעיבוד.
השראה מתמונה ועיבוד
כשמספקים תמונה, הסבירו איזו סצנה או אווירה היא תורמת לבקשת המוזיקה. נוף רגוע וסצנת לילה צפופה מרמזים על כיוונים שונים, אך התפקיד הרגשי הרצוי עדיין צריך להיות מפורש בטקסט. שמרו את התמונה עם ההנחיה כשמשווים את הקליפ שהוחזר לרעיון המיועד.
בדקו את האיזון בין שירה, כלי נגינה והמשפט המוזיקלי המרכזי. בלולאה, האזינו לסוף ולהתחלה ברצף; בקטע תצוגה מקדימה, בדקו אם המשך הקצר מעביר את הכיוון המיועד. קליפ המלווה עריכה צריך להיבדק מול אותה עריכה ולא רק בנפרד.
שמרו את תוצר ההאזנה
שמרו את האודיו בפועל וכל טקסט נלווה עם הבריף. בדקו את מאפייני הקובץ בעת הכנת השמעה או ייבוא לעורך, ושמרו כל מידע על מילות שיר או תזמון שהבקשה החזירה. המוזיקה היא פלט המודל; אפשר לארגן חיתוכים, כותרות, מעברים חזותיים ומיקס הפקה סופי סביב הנכס שנבדק.
פרופיל Clip Preview המדויק הזה מתאים לתוצר מוזיקלי קומפקטי. שמרו על תפקידו בפורמט הקצר כמובחן בעת תכנון יצירה ארוכה יותר, ובחרו את הקליפ שהוחזר באמצעות האזנה למשפט המוזיקלי המלא, לניסוח המושר ולסיום.
Ailoot · מוזיקה POST /v1/music/generations google/lyria-3-clip-preview
google/lyria-3-clip-previewהתחלה
Lyria 3 Clip Preview הוא מודל המוזיקה של Google לקליפים קצרים, לולאות וקטעי תצוגה מקדימה. הוא מקבל השראה מטקסט או מתמונה ומפיק מוזיקה באורך 30 שניות עם אודיו סטריאו ב־48 kHz, ותומך בשירה, במילות שיר מתוזמנות ובעיבודים אינסטרומנטליים.
- סוגי קלט נתמכים
- טקסט
- תוצאות
- music
זמין ב-Ailoot · קלט ושיטות
Ailoot · מוזיקה POST /v1/music/generations
- סוגי קלט
text- סוגי פלט
music- פורמט פלט
- קטעי אודיו שלמים בבעלותכם / קישורי JSON
| שדה | סוג | דרישה | ערכים ומגבלות | ברירת מחדל |
|---|---|---|---|---|
שדהmodel | סוגstring | דרישהחובה | ערכים ומגבלות google/lyria-3-clip-preview | ברירת מחדל— |
שדהprompt | סוגstring | דרישהחובה | ערכים ומגבלות אורך מזערי: 1 | ברירת מחדל— |
שילובים של חומרי קלט
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.04 $ לכל קטע
- לעיון בלבד · אינו מתווסף
- 0.04 $ לכל בקשה
קליפים שנמסרו × תעריף בסיס לקליפ. תעריף הייחוס לבקשה אינו מתווסף. הדוגמאות לפני התאמות החלות.
1 × 0.04 $ = 0.04 $
לפני הבקשה Ailoot משריינת סכום משוער. לאחר קבלת התוצאה היא מסדירה את החיוב הסופי לפי השימוש המדוד. הסדרת חיוב בהזרמה משתמשת ברשומת השימוש הסופית. איך פועלים שריון הסכום והסדרת החיוב →
פרטי תעריף הייחוס
טבלאות הייחוס ברמת המודל אינן משנות את בחירת השיטה, הצעות המחיר או החיובים. החיובים בפועל משתמשים בתעריפי שיטת Ailoot שנבחרה.
טבלאות ייחוס של המודל
מחירים לפי תצורה
| תצורה | רמת שירות | תנאי הקשר | חיוב |
|---|---|---|---|
| תצורהUltra | רמת שירותstandard | תנאי הקשר{} | חיוב פלט · מוזיקה 0.08 $ לכל שיר |
דוגמאות לבקשות
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-3-clip-preview", "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-3-clip-preview
כינויים לנתיבי שיטות
השתמשו בנתיבי השיטות המוצגים למעלה.
מזהי מודלים קשורים IDs
FAQ · Lyria 3 Clip Preview
- אילו קלטים ותוצאות זמינים?
POST /v1/music/generations·google/lyria-3-clip-preview:text→music- באילו שדות הבקשה משתמשת?
POST /v1/music/generations·google/lyria-3-clip-preview:model,prompt