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 US$ لكل مقطع
- مرجع فقط · لا يُضاف
- 0.04 US$ لكل طلب
المقاطع المسلّمة × السعر الأساسي للمقطع. لا يُضاف السعر المرجعي لكل طلب. الأمثلة قبل التعديلات المطبقة.
1 × 0.04 US$ = 0.04 US$
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
تفاصيل التعرفة المرجعية
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
جداول التعرفة المرجعية للنموذج
الأسعار حسب الإعدادات
| الإعدادات | فئة الخدمة | شرط السياق | الرسوم |
|---|---|---|---|
| الإعداداتUltra | فئة الخدمةstandard | شرط السياق{} | الرسوم الإخراج · موسيقى 0.08 US$ لكل أغنية |
أمثلة للطلبات
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 والبيانات الوصفية. الطريقة متزامنة؛ ولا يُستحدث عنوان URL منفصل للاستعلام عن حالة توليد الموسيقى في 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