Lyria 3 Clip Preview هو ملف توليد الموسيقى من Google للمقاطع القصيرة والحلقات والمعاينات. يقبل وصفًا نصيًا أو صورة للإلهام، ويعيد نصًا وصوتًا. ويصف الملف المنشور مقاطع من 30 ثانية بصوت ستيريو بتردد 48 kHz، تشمل الغناء وكلمات الأغنية الموقّتة والتوزيعات الكاملة للآلات الموسيقية.
حدّد غرض المقطع والمزاج الذي ينبغي أن يحمله. ويمكن للحن افتتاحي قصير تحديد مقدمة هادئة ولحظة دخول واضحة؛ ويمكن لمقطع خلفية تحديد الإيقاع والملمس الصوتي اللازمين خلف مشهد مرئي. بيّن ما إذا كان ينبغي أن تتضمن النتيجة غناءً أم تكون موسيقى آلية، واذكر العناصر الموسيقية المهمة للموجز.
اجعل البنية مناسبة لقِصر المقطع. حدّد الافتتاح والعبارة الموسيقية الرئيسية والنهاية أو نقطة التكرار. وإذا كانت الكلمات مهمة، فقدّم الفكرة الغنائية أو الصياغة المقصودة وافحص النتيجة المغنّاة الفعلية. وينبغي للموجز الموسيقي أن يميّز المحتوى الغنائي عن توجيهات التوزيع.
عند تقديم صورة، اشرح المشهد أو المزاج الذي تضيفه إلى طلب الموسيقى. فالمنظر الطبيعي الهادئ والمشهد الليلي المزدحم يوحيان باتجاهين مختلفين، لكن ينبغي أن يظل الدور الشعوري المطلوب صريحًا في النص. واحتفظ بالصورة مع الوصف عند مقارنة المقطع المُعاد بالفكرة المقصودة.
راجع التوازن بين الغناء والآلات والعبارة الموسيقية الرئيسية. وفي الحلقة، استمع إلى النهاية والبداية معًا؛ وفي المعاينة، تحقّق مما إذا كانت المدة القصيرة توصل الاتجاه المقصود. وينبغي مراجعة المقطع الذي يصاحب مونتاجًا في ضوء ذلك المونتاج، لا بمفرده فقط.
احفظ الصوت الفعلي وأي نص مصاحب مع الموجز. وافحص خصائص ملفه عند تجهيز التشغيل أو استيراده إلى محرّر، واحتفظ بأي معلومات لكلمات الأغنية أو التوقيت أعادها الطلب. والموسيقى هي مخرج النموذج؛ ويمكن ترتيب القصّات والعناوين والانتقالات المرئية والمزيج الإنتاجي النهائي حول هذا الأصل الذي جرى فحصه.
يناسب ملف Clip Preview المحدد هذا ناتجًا موسيقيًا موجزًا. وحافظ على تمييز دوره في المقاطع القصيرة عند التخطيط لمؤلّفة أطول، واختر المقطع المُعاد بالاستماع إلى العبارة كاملةً والكلمات المغنّاة والنهاية.
", "aboutText": "Lyria 3 Clip Preview هو ملف توليد الموسيقى من Google للمقاطع القصيرة والحلقات والمعاينات. يقبل وصفًا نصيًا أو صورة للإلهام، ويعيد نصًا وصوتًا. ويصف الملف المنشور مقاطع من 30 ثانية بصوت ستيريو بتردد 48 kHz، تشمل الغناء وكلمات الأغنية الموقّتة والتوزيعات الكاملة للآلات الموسيقية.\n\n### صِف اللحظة الموسيقية\n\nحدّد غرض المقطع والمزاج الذي ينبغي أن يحمله. ويمكن للحن افتتاحي قصير تحديد مقدمة هادئة ولحظة دخول واضحة؛ ويمكن لمقطع خلفية تحديد الإيقاع والملمس الصوتي اللازمين خلف مشهد مرئي. بيّن ما إذا كان ينبغي أن تتضمن النتيجة غناءً أم تكون موسيقى آلية، واذكر العناصر الموسيقية المهمة للموجز.\n\nاجعل البنية مناسبة لقِصر المقطع. حدّد الافتتاح والعبارة الموسيقية الرئيسية والنهاية أو نقطة التكرار. وإذا كانت الكلمات مهمة، فقدّم الفكرة الغنائية أو الصياغة المقصودة وافحص النتيجة المغنّاة الفعلية. وينبغي للموجز الموسيقي أن يميّز المحتوى الغنائي عن توجيهات التوزيع.\n\n### الإلهام من الصور والتوزيع\n\nعند تقديم صورة، اشرح المشهد أو المزاج الذي تضيفه إلى طلب الموسيقى. فالمنظر الطبيعي الهادئ والمشهد الليلي المزدحم يوحيان باتجاهين مختلفين، لكن ينبغي أن يظل الدور الشعوري المطلوب صريحًا في النص. واحتفظ بالصورة مع الوصف عند مقارنة المقطع المُعاد بالفكرة المقصودة.\n\nراجع التوازن بين الغناء والآلات والعبارة الموسيقية الرئيسية. وفي الحلقة، استمع إلى النهاية والبداية معًا؛ وفي المعاينة، تحقّق مما إذا كانت المدة القصيرة توصل الاتجاه المقصود. وينبغي مراجعة المقطع الذي يصاحب مونتاجًا في ضوء ذلك المونتاج، لا بمفرده فقط.\n\n### احتفظ بالملف الصوتي للاستماع\n\nاحفظ الصوت الفعلي وأي نص مصاحب مع الموجز. وافحص خصائص ملفه عند تجهيز التشغيل أو استيراده إلى محرّر، واحتفظ بأي معلومات لكلمات الأغنية أو التوقيت أعادها الطلب. والموسيقى هي مخرج النموذج؛ ويمكن ترتيب القصّات والعناوين والانتقالات المرئية والمزيج الإنتاجي النهائي حول هذا الأصل الذي جرى فحصه.\n\nيناسب ملف Clip Preview المحدد هذا ناتجًا موسيقيًا موجزًا. وحافظ على تمييز دوره في المقاطع القصيرة عند التخطيط لمؤلّفة أطول، واختر المقطع المُعاد بالاستماع إلى العبارة كاملةً والكلمات المغنّاة والنهاية.", "editorialOverlay": { "copy_fields": null, "copy_sha256": null, "copy_source": null, "html_sha256": "37d34df2a23024a2e774b0b77fc64feec6ff5fefd9185d047b03aac9a8be4307", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "google/lyria-3-clip-previewLyria 3 Clip Preview هو نموذج الموسيقى من Google للمقاطع القصيرة والحلقات والمعاينات. يستلهم من النص أو الصور، وينتج موسيقى مدتها 30 ثانية بصوت ستيريو بتردد 48 kHz، مع دعم الغناء وكلمات الأغنية الموقّتة والتوزيعات الموسيقية الآلية.
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Lyria 3 Clip Preview هو ملف توليد الموسيقى من Google للمقاطع القصيرة والحلقات والمعاينات. يقبل وصفًا نصيًا أو صورة للإلهام، ويعيد نصًا وصوتًا. ويصف الملف المنشور مقاطع من 30 ثانية بصوت ستيريو بتردد 48 kHz، تشمل الغناء وكلمات الأغنية الموقّتة والتوزيعات الكاملة للآلات الموسيقية.
حدّد غرض المقطع والمزاج الذي ينبغي أن يحمله. ويمكن للحن افتتاحي قصير تحديد مقدمة هادئة ولحظة دخول واضحة؛ ويمكن لمقطع خلفية تحديد الإيقاع والملمس الصوتي اللازمين خلف مشهد مرئي. بيّن ما إذا كان ينبغي أن تتضمن النتيجة غناءً أم تكون موسيقى آلية، واذكر العناصر الموسيقية المهمة للموجز.
اجعل البنية مناسبة لقِصر المقطع. حدّد الافتتاح والعبارة الموسيقية الرئيسية والنهاية أو نقطة التكرار. وإذا كانت الكلمات مهمة، فقدّم الفكرة الغنائية أو الصياغة المقصودة وافحص النتيجة المغنّاة الفعلية. وينبغي للموجز الموسيقي أن يميّز المحتوى الغنائي عن توجيهات التوزيع.
عند تقديم صورة، اشرح المشهد أو المزاج الذي تضيفه إلى طلب الموسيقى. فالمنظر الطبيعي الهادئ والمشهد الليلي المزدحم يوحيان باتجاهين مختلفين، لكن ينبغي أن يظل الدور الشعوري المطلوب صريحًا في النص. واحتفظ بالصورة مع الوصف عند مقارنة المقطع المُعاد بالفكرة المقصودة.
راجع التوازن بين الغناء والآلات والعبارة الموسيقية الرئيسية. وفي الحلقة، استمع إلى النهاية والبداية معًا؛ وفي المعاينة، تحقّق مما إذا كانت المدة القصيرة توصل الاتجاه المقصود. وينبغي مراجعة المقطع الذي يصاحب مونتاجًا في ضوء ذلك المونتاج، لا بمفرده فقط.
احفظ الصوت الفعلي وأي نص مصاحب مع الموجز. وافحص خصائص ملفه عند تجهيز التشغيل أو استيراده إلى محرّر، واحتفظ بأي معلومات لكلمات الأغنية أو التوقيت أعادها الطلب. والموسيقى هي مخرج النموذج؛ ويمكن ترتيب القصّات والعناوين والانتقالات المرئية والمزيج الإنتاجي النهائي حول هذا الأصل الذي جرى فحصه.
يناسب ملف Clip Preview المحدد هذا ناتجًا موسيقيًا موجزًا. وحافظ على تمييز دوره في المقاطع القصيرة عند التخطيط لمؤلّفة أطول، واختر المقطع المُعاد بالاستماع إلى العبارة كاملةً والكلمات المغنّاة والنهاية.
POST /v1/music/generationstextmusic| الحقل | النوع | المتطلب | القيم والحدود | القيمة الافتراضية |
|---|---|---|---|---|
الحقل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}
بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب.
POST /v1/music/generationsالمقاطع المسلّمة × السعر الأساسي للمقطع. لا يُضاف السعر المرجعي لكل طلب. الأمثلة قبل التعديلات المطبقة.
1 × 0.04 US$ = 0.04 US$
تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →
لا تغيّر جداول التعرفة المرجعية على مستوى النموذج اختيار الطريقة أو عروض الأسعار أو الرسوم. وتستخدم الرسوم الفعلية تعرفات طريقة Ailoot المحددة.
| الإعدادات | فئة الخدمة | شرط السياق | الرسوم |
|---|---|---|---|
| الإعداداتUltra | فئة الخدمةstandard | شرط السياق{} | الرسوم الإخراج · موسيقى 0.08 US$ لكل أغنية |
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-3-clip-preview", "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 والبيانات الوصفية. الطريقة متزامنة؛ ولا يُستحدث عنوان 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
استخدم مسارات الطرائق المعروضة أعلاه.