النماذج

Lyria

Markdown · JSON

Lyria

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

عن النموذج

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

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

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

Ailoot · الموسيقى POST /v1/music/generations google/lyria

google/lyria

Google /google/lyria

البداية

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

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

متاح في 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
: "${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", "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}/content
  • GET /v1/media/assets
  • GET /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

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

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

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

google/lyria

FAQ · Lyria
ما المدخلات والنتائج المتاحة؟

POST /v1/music/generations · google/lyria: text → music

ما الحقول التي يستخدمها الطلب؟

POST /v1/music/generations · google/lyria: model, prompt, n, count

ما الحدود المطبقة؟

POST /v1/music/generations · google/lyria: n.minimum: 1; n.maximum: 8; count.minimum: 1; count.maximum: 8

المزيد من التفاصيل

اربط Ailoot بخدمة Claude Code أوOpenCode أوHermes أوتطبيقك.

الشركة ومحفظة مشاريعها

الشركة ومحفظة مشاريعها: ملايين العملاء؛ مبيعات بالمليارات شهريًا.

اشتر الرموز بخصم.

خصم اشتراك للعمل المنتظم. الرموز الترويجية حتى 50% على شراء الرموز.

الاشتراك
اختر خطة بخصم لطلباتك المنتظمة.
رمز خصم حتى 50%
أدخل الرمز عند الشراء. يعاد حساب السعر وفق العرض الساري.
المصروفات في السجل
يحفظ النموذج والرموز والمبلغ لكل طلب.

اختر اشتراكا · اعرض أسعار النماذج

اربط API بالمنتج الذي تبيعه.

SaaS والتطبيقات والبوتات وفق العرض واتفاقية ترخيص Ailoot. لإعادة البيع، اطلب ترخيص موزع.

تطبيق تجاري
أضف توليد النص والصور والفيديو والصوت إلى ميزات خدمتك المدفوعة.
ترخيص إعادة البيع
أرسل وصف المشروع وطريقة توفير الوصول. اطلب شروط استخدام وإعادة بيع مكتوبة.
المستندات على الموقع
العرض واتفاقية الترخيص وسياسة معالجة البيانات متاحة قبل الربط.

اطلب ترخيص إعادة بيع · العرض واتفاقية الترخيص