{ "aboutHtml": "

ينشئ google/lyria موسيقى من طلب مكتوب عبر /v1/music/generations. استخدام ملموس هو خلفية آلات هادئة لعرض منتج، مع وصف الآلات البارزة والمساحة المطلوبة للتعليق الصوتي. اختر المسار عندما تكون النتيجة المطلوبة مقطعًا موسيقيًا مولدًا.

يتطلب الطلب model وprompt. يقبل n أو count مقطعًا واحدًا حتى ثمانية، وتعيد الطريقة نتيجة التوليد تزامنيًا. احفظ كل مقطع وبياناته الفعلية. لا يتيح الإدخال مرجعًا صوتيًا أو إعداد مدة أو حقل سرعة إيقاع، فلا يمكن اختيارها كأدوات تحكم مستقلة. صف النية الموسيقية في prompt دون اعتبارها خاصية خرج مقاسة مضمونة.

", "aboutText": "ينشئ google/lyria موسيقى من طلب مكتوب عبر /v1/music/generations. استخدام ملموس هو خلفية آلات هادئة لعرض منتج، مع وصف الآلات البارزة والمساحة المطلوبة للتعليق الصوتي. اختر المسار عندما تكون النتيجة المطلوبة مقطعًا موسيقيًا مولدًا. يتطلب الطلب model وprompt. يقبل n أو count مقطعًا واحدًا حتى ثمانية، وتعيد الطريقة نتيجة التوليد تزامنيًا. احفظ كل مقطع وبياناته الفعلية. لا يتيح الإدخال مرجعًا صوتيًا أو إعداد مدة أو حقل سرعة إيقاع، فلا يمكن اختيارها كأدوات تحكم مستقلة. صف النية الموسيقية في prompt دون اعتبارها خاصية خرج مقاسة مضمونة.", "editorialOverlay": { "copy_fields": { "about_html": "

ينشئ google/lyria موسيقى من طلب مكتوب عبر /v1/music/generations. استخدام ملموس هو خلفية آلات هادئة لعرض منتج، مع وصف الآلات البارزة والمساحة المطلوبة للتعليق الصوتي. اختر المسار عندما تكون النتيجة المطلوبة مقطعًا موسيقيًا مولدًا.

يتطلب الطلب model وprompt. يقبل n أو count مقطعًا واحدًا حتى ثمانية، وتعيد الطريقة نتيجة التوليد تزامنيًا. احفظ كل مقطع وبياناته الفعلية. لا يتيح الإدخال مرجعًا صوتيًا أو إعداد مدة أو حقل سرعة إيقاع، فلا يمكن اختيارها كأدوات تحكم مستقلة. صف النية الموسيقية في prompt دون اعتبارها خاصية خرج مقاسة مضمونة.

", "short_text": "توليد موسيقى من النص، بطلب مقطع واحد إلى ثمانية وتسليم النتيجة تزامنيًا." }, "copy_sha256": "1389e104bec9261873d08c83ce16b8204450a85e5f82238b67602ddf4d75c876", "copy_source": { "locale": "ar", "pack_sha256": "0f56d90ba41881e1134accf82e57338f246f8753ca4c0cee929aaffada5d10e7", "record_model_id": "google/lyria", "source_facts_sha256": "648f7ead8d7699173857247d7880cc3602d8db1ccb66e51989f6dba5d72192c9", "validation_sha256": "a2ac2f28056280fc0b2ea34a501bf156d5ce155406e57e708edf30bfdf6bfdc6" }, "html_sha256": "310f36c8f501699364bdc9716ef69b7f8090bca4159fa89aff58a9c15342ac2d", "module_sha256": "ee9dc1c50b1e6a8fb7fa062030fcb4646b9aaaeb08be513b723a5a92a7290f06", "raw_model_unchanged": true, "schema": "ailoot-native-model-editorial-v1" }, "locale": "ar", "methods": [ { "html": "
G

Lyria

Google /google/lyria

البداية

توليد موسيقى من النص، بطلب مقطع واحد إلى ثمانية وتسليم النتيجة تزامنيًا.

المدخلات المقبولة
النص
النتائج
music
عن النموذج

يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.

ينشئ google/lyria موسيقى من طلب مكتوب عبر /v1/music/generations. استخدام ملموس هو خلفية آلات هادئة لعرض منتج، مع وصف الآلات البارزة والمساحة المطلوبة للتعليق الصوتي. اختر المسار عندما تكون النتيجة المطلوبة مقطعًا موسيقيًا مولدًا.

يتطلب الطلب model وprompt. يقبل n أو count مقطعًا واحدًا حتى ثمانية، وتعيد الطريقة نتيجة التوليد تزامنيًا. احفظ كل مقطع وبياناته الفعلية. لا يتيح الإدخال مرجعًا صوتيًا أو إعداد مدة أو حقل سرعة إيقاع، فلا يمكن اختيارها كأدوات تحكم مستقلة. صف النية الموسيقية في prompt دون اعتبارها خاصية خرج مقاسة مضمونة.

متاح في 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 أيضاً، فيجب أن يتطابق العدد معه
القيمة الافتراضية—
تركيبات مواد الإدخال

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 US$⁩ لكل مقطع
مرجع فقط · لا يُضاف
⁦‏0.08 US$⁩ لكل طلب

المقاطع المسلّمة × السعر الأساسي للمقطع. لا يُضاف السعر المرجعي لكل طلب. الأمثلة قبل التعديلات المطبقة.

1 × ⁦‏0.08 US$⁩ = ⁦‏0.08 US$⁩

4 × ⁦‏0.08 US$⁩ = ⁦‏0.32 US$⁩

تحجز Ailoot مبلغًا تقديريًا قبل الطلب. وبعد ظهور النتيجة، تُسوّي الرسوم النهائية بناءً على الاستخدام المقاس. وتستخدم تسوية البث سجل الاستخدام النهائي. كيفية عمل حجز المبلغ وتسوية الرسوم →

أمثلة للطلبات

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

استلام النتائج وحفظها

Ailoot · الموسيقى

المقاطع الصوتية الكاملة المملوكة لك / روابط JSON

الاحتفاظ بكل النتائج المكتملة

احتفظ بكل استجابة كاملة وكل ملف وجزء محتوى تم إرجاعه.

احفظ أو اجلب كل مقطع مُعاد، واحتفظ بالمعرّف الفعلي و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

الأسماء البديلة لمسارات الطرائق

استخدم مسارات الطرائق المعروضة أعلاه.

معرّفات النماذج ذات الصلة IDs

google/lyria

", "method_identity": { "effective_request_model_id": "google/lyria", "fmt": "music", "http": "POST", "path": "/v1/music/generations", "request_model_id": "google/lyria", "route_label": "Core" }, "method_key": "Core|music|/v1/music/generations|google%2Flyria", "ordinal": 0, "rawMethod": { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save/fetch every returned clip and preserve actual ID, MIME and metadata. The method is synchronous; no separate Ailoot music generationpollingURL is introduced.", "errors": [ { "code": null, "condition": "حقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة", "http_status": 400, "recovery": "صحّح الحقول المحددة قبل طلب إنشاء جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "تشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق", "http_status": null, "recovery": "احتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "إذا كانت نتيجة الموسيقى تتطلب التحقق، فاحتفظ بـoperation_id/X-Client-Request-ID الأصليين وبمعلومات المقاطع المُعادة. استعد المقاطع الموجودة المملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تعِد إرسال طلب الموسيقى، ولا تُنشئ عنوان URL للاستعلام عن التوليد انطلاقاً من operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_music", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_music" ], "outputs": { "all_results": "احفظ أو اجلب كل مقطع مُعاد، واحتفظ بالمعرّف الفعلي وMIME والبيانات الوصفية. الطريقة متزامنة؛ ولا يُستحدث عنوان URL منفصل للاستعلام عن حالة توليد الموسيقى في Ailoot.", "family": "music", "fields": [ { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "response_id", "type": "string" }, { "description": null, "name": "data[]", "type": "owned clip record" } ], "format": "المقاطع الصوتية الكاملة المملوكة لك / روابط JSON" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/lyria" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "conditions": "إذا قُدِّم n أيضاً، فيجب أن يتطابق العدد معه", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "count", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [] }, "hints": [ "بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب." ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If a music result requires a check, keep the original operation_id/X-Client-Request-ID and returned clip information. Recover existing owned clips through the media library using actual task_id or asset_id values. Do not resubmit the music request or construct a generation polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/music/generations" }, "operation_modes": [ "music" ], "output": { "family": [ "music" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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", "label": "Compose from your actual music brief", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "الموسيقى", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "music" ], "path": "/v1/music/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "music_output_clip", "label": "per clip", "side": "out" }, { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "per_request", "label": "per request", "side": "out" } ] } ], "request_model_id": "google/lyria", "route_label": "Core", "status_reads": [], "tiers": [], "tool_prices": null, "unit": "music_output_clip", "units": [ { "key": "music_output_clip", "label": "per clip", "side": "out", "usd": 0.08 }, { "key": "per_request", "label": "per request", "side": "out", "usd": 0.08 } ] } } ], "model_id": "google/lyria", "nativeProvenance": { "input_facts_canonical_sha256": "cf89bb94fd7a108e206608e2f8d012ff22f65816c8c3bd448ecaac246e61fb4e", "input_html_sha256": "22e11f799752ab285b2c149232de6d13a2b669b9684c7e02b48904bfe36a4d15", "private_audit_sha256": "27af91c2c79d1c1431953c618e40136a0d746e7a0e74b7266cf93e4701946583", "role": "historical-normalized-input-audit-hashes", "schema": "ailoot-native-model-provenance-v2" }, "page": { "canonical": "https://ailoot.ai/models/ar/google-lyria/", "description": "توليد موسيقى من النص، بطلب مقطع واحد إلى ثمانية وتسليم النتيجة تزامنيًا.", "locale": "ar", "md_url": "https://ailoot.ai/models/ar/google-lyria/index.md", "title": "Lyria — Ailoot", "url": "https://ailoot.ai/models/ar/google-lyria/" }, "rawModel": { "about": "Lyria هو خيار توليد الموسيقى المحدد بالاسم والمقدّم هنا بإدخال نصي وإخراج موسيقي.\n\nاكتب الموجز حول ما ينبغي أن يسمعه المستمع. حدّد المزاج والآلات التي تريد إبرازها والإيقاع والاستخدام المقصود. يمكن لموجز مشهد التمييز بين بداية هادئة ووسط أكثر حيوية ونهاية متحفظة.\n\nوللموسيقى الخلفية، اشرح ما إذا كان المقطع ينبغي أن يدعم السرد أو يحمل المشهد وحده. صِف الخصائص الموسيقية مباشرةً، مثل بيانو بنغمات متباعدة أو نبض منتظم أو نسيج أوركسترالي دافئ.", "alias_of": null, "aliases": [], "author": "Google", "ctx": null, "formats": [ "music" ], "id": "google/lyria", "input": [ "text" ], "kind": "music", "max_out": null, "methods": [ { "cache_read": null, "cache_write": null, "cache_write_1h": null, "cache_write_5m": null, "conditional_meter": null, "contract": { "data": { "all_results": "Save/fetch every returned clip and preserve actual ID, MIME and metadata. The method is synchronous; no separate Ailoot music generationpollingURL is introduced.", "errors": [ { "code": null, "condition": "حقول مطلوبة أو تمثيل مادة أو قيمة معلمة غير صحيحة", "http_status": 400, "recovery": "صحّح الحقول المحددة قبل طلب إنشاء جديد.", "type": "invalid_request_error" }, { "code": null, "condition": "تشير الاستجابة المُعادة إلى أن العملية أو النتيجة تتطلب التحقق", "http_status": null, "recovery": "احتفظ بمعرّف العملية أو المهمة الأصلي المُعاد، وبترويسات الطلب وبالاستجابة؛ وواصل عمليات القراءة المدعومة لتلك العملية الأصلية. لا تُعِد إرسال طلب الإنشاء.", "type": "server_error" } ], "hints": [], "ignored_fields": [], "lifecycle": { "all_results": "Follow everyactualreturnedoutputandownedasset; no result is discardedbecauseindex0orcontent_urlalreadyexists.", "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "actual returned task_id or media library record", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "إذا كانت نتيجة الموسيقى تتطلب التحقق، فاحتفظ بـoperation_id/X-Client-Request-ID الأصليين وبمعلومات المقاطع المُعادة. استعد المقاطع الموجودة المملوكة لك عبر مكتبة الوسائط باستخدام قيم task_id أو asset_id الفعلية. لا تعِد إرسال طلب الموسيقى، ولا تُنشئ عنوان URL للاستعلام عن التوليد انطلاقاً من operation_id." }, "material_combinations": [ { "content_type": "application/json", "mode": "text_to_music", "required": [ "prompt" ] } ], "media_library": { "asset": { "fields": [ { "description": null, "name": "asset_id", "type": "string" }, { "description": null, "name": "task_id", "type": "string" }, { "description": null, "name": "output_key", "type": "string" }, { "description": null, "name": "family", "type": "string" }, { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "method", "type": "string" }, { "description": null, "name": "status", "type": "string" }, { "description": null, "name": "content_type", "type": "string" }, { "description": null, "name": "sha256", "type": "string" }, { "description": null, "name": "size_bytes", "type": "integer" }, { "description": null, "name": "content_url", "type": "string" } ], "http": "GET", "id_source": "actual returned asset_id", "path": "/v1/media/assets/{asset_id}" }, "content": { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "range_header_supported": true, "url_source": "Use exact returned signed content_url including its token; do not construct a token." }, "expired_link": { "code": "link_expired", "http_status": 404, "recovery": "Read the asset again to obtain its refreshed signed content_url, then fetch that URL. Do not regenerate." }, "list": { "all_pages": "Follow every returned next_cursor, then select records by their actual task_id/output_key.", "http": "GET", "output_fields": [ { "description": null, "name": "object", "type": "string" }, { "description": null, "name": "data", "type": "asset[]" }, { "description": null, "name": "next_cursor", "type": "string|null" } ], "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "family", "required": false, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "name": "cursor", "required": false, "type": "string" }, { "availability": "source_interface", "default": 20, "default_known": true, "enum": null, "enum_known": false, "maximum": 100, "minimum": 1, "name": "limit", "required": false, "type": "integer" } ], "path": "/v1/media/assets" }, "revoke": { "http": "DELETE", "meaning": "Revokes/deletes the existing owned file; this is not generation cancellation.", "path": "/v1/media/assets/{asset_id}", "pending_status": "revoking", "success_statuses": [ 202, 204 ] }, "task": { "http": "GET", "id_source": "actual returned task_id or media library record; operation_id is not task_id", "path": "/v1/media/tasks/{task_id}" } }, "operation_modes": [ "text_to_music" ], "outputs": { "all_results": "احفظ أو اجلب كل مقطع مُعاد، واحتفظ بالمعرّف الفعلي وMIME والبيانات الوصفية. الطريقة متزامنة؛ ولا يُستحدث عنوان URL منفصل للاستعلام عن حالة توليد الموسيقى في Ailoot.", "family": "music", "fields": [ { "description": null, "name": "model", "type": "string" }, { "description": null, "name": "response_id", "type": "string" }, { "description": null, "name": "data[]", "type": "owned clip record" } ], "format": "المقاطع الصوتية الكاملة المملوكة لك / روابط JSON" }, "parameters": [ { "availability": "source_interface", "default": null, "default_known": false, "enum": [ "google/lyria" ], "enum_known": true, "name": "model", "required": true, "type": "string" }, { "availability": "source_interface", "default": null, "default_known": false, "enum": null, "enum_known": false, "min_length": 1, "name": "prompt", "required": true, "type": "string" }, { "availability": "source_interface", "default": 1, "default_known": true, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "n", "required": false, "type": "integer" }, { "availability": "source_interface", "conditions": "إذا قُدِّم n أيضاً، فيجب أن يتطابق العدد معه", "default": null, "default_known": false, "enum": null, "enum_known": false, "maximum": 8, "minimum": 1, "name": "count", "required": false, "type": "integer" } ], "profile_binding": "Exact existing Ailoot model and method; interface constraints below do not assert provider qualification.", "unsupported": [] }, "hints": [ "بُنى الطرق ومعرّفاتها دقيقة؛ قدرة المورد منفصلة عن السماح بالطلب." ], "input": { "material_types": [ "text" ], "optional_controls": null, "required": null }, "lifecycle": { "assets": [ { "http": "GET", "path": "/v1/media/assets" }, { "http": "GET", "path": "/v1/media/assets/{asset_id}" } ], "content": [ { "http": "GET", "path": "/v1/media/assets/{asset_id}/content", "url_source": "exact returned signed URL; never construct token" } ], "mode": "synchronous_result_then_owned_library", "operation_id_is_not_task_id": true, "status": [ { "http": "GET", "id_source": "قيمة task_id الفعلية المُعادة أو سجل مكتبة الوسائط", "path": "/v1/media/tasks/{task_id}" } ], "unknown": "If a music result requires a check, keep the original operation_id/X-Client-Request-ID and returned clip information. Recover existing owned clips through the media library using actual task_id or asset_id values. Do not resubmit the music request or construct a generation polling URL from operation_id." }, "method": { "http": "POST", "path": "/v1/music/generations" }, "operation_modes": [ "music" ], "output": { "family": [ "music" ], "format": null, "multioutputs": "retain every actual response output" } }, "ctx": null, "examples": [ { "code": "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", "label": "Compose from your actual music brief", "language": "bash" } ], "family": "openai", "fast_multiplier": null, "flex_multiplier": null, "fmt": "music", "http": "POST", "img_in": null, "img_out": null, "in": null, "input": [ "text" ], "label": "الموسيقى", "max_out": null, "max_tool_calls": null, "out": null, "output": [ "music" ], "path": "/v1/music/generations", "pricing_profiles": [ { "dimensions": {}, "label": "Core", "units": [ { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "music_output_clip", "label": "per clip", "side": "out" }, { "amount": 0.08, "amount_unit": "usd_per_display_unit", "key": "per_request", "label": "per request", "side": "out" } ] } ], "request_model_id": "google/lyria", "route_label": "Core", "status_reads": [], "tiers": [], "tool_prices": null, "unit": "music_output_clip", "units": [ { "key": "music_output_clip", "label": "per clip", "side": "out", "usd": 0.08 }, { "key": "per_request", "label": "per request", "side": "out", "usd": 0.08 } ] } ], "model_aliases": [ { "canonical_model_id": "google/lyria", "request_model_id": "google/lyria", "route_label": "Core" } ], "name": "Lyria", "price": { "in": null, "in_label": null, "out": 0.08, "out_label": "per clip", "sort_in": null, "sort_out": null, "varies": false }, "short": "Lyria هو خيار محدد بالاسم لتحويل النص إلى موسيقى. صِف المزاج والآلات والإيقاع والمشهد المقصود لتشكيل موجز موسيقي لفيديو أو عرض تقديمي أو مشروع إبداعي." }, "renderer_schema": { "method_order": "Original DTO methods order; every exact route/format/path/caller survives.", "prices": "Original public DTO fields and original native display HTML; no flattened or normalized offers." }, "representation": "exact-public-dto-and-native-renderer-html", "representationNotes": { "current_reference": { "about_json_pointer": "/aboutHtml", "methods": [ { "contract_json_pointer": "/methods/0/rawMethod/contract", "html_json_pointer": "/methods/0/html", "method_ordinal": 0 } ], "role": "current-semantic-reference" }, "raw_input": { "examples_role": "historical-input-not-current-ready-examples", "json_pointers": [ "/rawModel", "/methods/0/rawMethod" ], "role": "historical-owner-input" }, "schema": "ailoot-native-model-representations-v1" }, "schema": "ailoot-static-model-facts-v1", "schema_version": 1, "shortText": "توليد موسيقى من النص، بطلب مقطع واحد إلى ثمانية وتسليم النتيجة تزامنيًا.", "source": { "audit_sha256": "2e00086bcbfc28e64d0cebe97aa47c17d8d5618963027f8ffb9dc6123d7d25b1", "bridge_map_sha256": "1125275768b9636fc8461bc7da5061239a81ddfe508e2557843ca42c58ab0036", "raw_model_json_sha256": "1a7794495954d102ca9993608375a0c85ee0942497fa9359414afd462119a0e5", "renderer_sha256": "081ee0fd5b6b1b60564b02c52d62547e01e922c8c0a16e91a0d055073e76a10e" }, "sourceRevision": "bfdf81ff32d9c01e62615b587afb45dc27543c32233f199728bb6305b39ce7c2" }