النماذج

suno-api

Markdown · JSON

suno-api

ينشئ Suno موسيقى من فكرة مكتوبة قصيرة. يُنتج مسار العمل التلقائي الموثّق أغنيتين، ويتضمن خيارًا للموسيقى الآلية، ويعيد الصوت المكتمل والبيانات الوصفية للمقاطع عبر مهمة التوليد.

عن النموذج

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

Suno خدمة لتوليد الموسيقى تحوّل فكرة مكتوبة إلى أغانٍ. يقبل مسار العمل التلقائي الموثّق وصفًا قصيرًا للموسيقى المقصودة واختيارًا للموسيقى الآلية، ثم يولّد أغنيتين. استخدم الوصف لتحديد الموضوع والأجواء والتوجه الموسيقي الذي تريد سماعه في المقاطع المكتملة.

ابدأ بالدور الذي ينبغي أن تؤديه الموسيقى. فخلفية هادئة لشرح، أو افتتاحية حيوية لفيديو قصير، أو أغنية تأملية عن رحلة، يمنح كل منها الوصف غرضًا ملموسًا. صِف الأجواء المقصودة والسمات الموسيقية المهمة لذلك الغرض في بضع عبارات واضحة.

في أغنية تتضمن غناءً، اجعل الموضوع واللغة واضحين في الموجز الإبداعي. صِف الفكرة التي ينبغي أن يعبّر عنها المقطع، والنبرة التي ينبغي أن ينقلها الأداء. استمع إلى النتيجة المكتملة لتقييم تكامل الغناء والكلمات والتوزيع الموسيقي. احتفظ بمعلومات المقطع الناتجة إلى جانب الصوت للمراجعة.

للحصول على موسيقى آلية، استخدم خيار الموسيقى الآلية الموثّق، وصِف التوجه الموسيقي في النص. حدّد الأجواء المطلوبة والآلات البارزة عندما تكون مهمة للمشروع. راجع المقطع المكتمل وفق الموضع الذي سيشغله في المونتاج، بما في ذلك الأجزاء التي ينبغي أن ترافق الكلام في الخلفية أو تدعم انتقالًا بصريًا.

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

يُنظَّم التوليد على هيئة مهمة. احتفظ بمعرّف المهمة المُعاد أثناء التحقّق من نتيجتها، وميّز المقاطع المكتملة من العناصر التي لا تزال قيد التنفيذ. تتضمن النتيجة الموثّقة معلومات على مستوى المقطع، مثل العنوان والحالة وموقع الملف الصوتي والمدة. احفظ الصوت المكتمل نفسه مع البيانات الوصفية المتاحة والوصف الأصلي.

في فيديو أو عرض تقديمي، جرّب الموسيقى المختارة مع المادة الفعلية. تحقّق من البداية والانتقالات والنهاية عند مستوى الصوت المقصود. حدّد الجزء الذي يخدم المونتاج، واحتفظ بالمقطع كاملًا للتغييرات اللاحقة. يُقيَّم المقتطف الموسيقي المناسب في سياق الصوت والصور وإيقاع العمل المكتمل.

احتفظ بالفكرة المكتوبة، وخيار الموسيقى الآلية، واختيار النموذج، وجميع المقاطع المكتملة معًا. عندما يحتاج مقطع مرشح إلى مراجعة، حدّد وجه عدم التوافق الموسيقي، مثل توزيع موسيقي مزدحم أكثر من اللازم خلف الكلام أو مقدمة تتطور ببطء مفرط. حافظ على التوجه المفيد، وعدّل الجزء من الوصف المرتبط بتلك المشكلة.

Ailoot Ultra · Music POST /v1/music/generations suno-api

suno-api

Suno /suno-api

البداية

ينشئ Suno موسيقى من فكرة مكتوبة قصيرة. يُنتج مسار العمل التلقائي الموثّق أغنيتين، ويتضمن خيارًا للموسيقى الآلية، ويعيد الصوت المكتمل والبيانات الوصفية للمقاطع عبر مهمة التوليد.

المدخلات المقبولة
النص
النتائج
الصوت · الصور · فيديو

متاح في Ailoot · المدخلات والطرائق

Ailoot Ultra · Music POST /v1/music/generations
الإدخال
text
الإخراج
audio, image, video
الحقلالنوعالمتطلبالقيم والحدودالقيمة الافتراضية
الحقلmodelالنوعstringالمتطلبمطلوبالقيم والحدود
suno-api
الشروط: استخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا.
القيمة الافتراضية—
الحقلgpt_description_promptالنوعstringالمتطلبمطلوبالقيم والحدود
الشروط: صِف الفكرة الموسيقية أو موضوع الأغنية.
القيمة الافتراضية—
الحقلmvالنوعstringالمتطلبمطلوبالقيم والحدود
chirp-fenix, chirp-crow, chirp-bluejay, chirp-auk, chirp-v4, chirp-v3-5
الشروط: اختر إصدارًا محددًا وموثقًا من Suno؛ يستخدم المثال chirp-crow (v5).
القيمة الافتراضية—
الحقلmake_instrumentalالنوعbooleanالمتطلبمطلوبالقيم والحدود
الشروط: اضبط القيمة على true للموسيقى دون غناء أو false للأغنية.
القيمة الافتراضية—
معلمات الطريقة ودورة حياتها
المعلمةالمواصفات
المعلمةcontent_typeالمواصفاتapplication/json
المعلمةrequiredالمواصفاتmodel, gpt_description_prompt, mv, make_instrumental
المعلمةoptionalالمواصفات
المعلمةmaterial_typesالمواصفاتtext
المعلمةconditionsالمواصفاتاستخدم مُحدِّد التوجيه هذا في Ailoot كما هو تمامًا., صِف الفكرة الموسيقية أو موضوع الأغنية., اختر إصدارًا محددًا وموثقًا من Suno؛ يستخدم المثال chirp-crow (v5)., اضبط القيمة على true للموسيقى دون غناء أو false للأغنية.

دورة الحياة: submit_once_poll_original

GET /v1/music/generations/{request_id}

GET /v1/media/assets

GET /v1/media/assets/{asset_id}

الباقات

كيفية احتساب الرسوم النهائية

تقدّر التعرفات المعروضة التكلفة قبل التوليد. تُحسب الرسوم النهائية من التكلفة المسجّلة لعملية التوليد الأصلية. مدة المخرجات المقاسة والكميات المتوقعة ليست الكمية النهائية الخاضعة للفوترة.

مراجع التسعير لا تضيف خيارات للطلب. المعلمات المدعومة مذكورة للطريقة المحددة.

الوضع السريع
غير محدد عند اختيار الوضع السريع
الوضع المرن
غير محدد عند اختيار وضع flex
أقصى جهد للاستدلال
غير محدد عندما يُطبَّق الضبط الافتراضي default مع أقصى جهد للاستدلال

تعرفات تقديرية للمقارنة

الأسعار حسب الإعدادات

طابق كل رسم مع الشروط المعروضة. طبّق تعرفة واحدة لكل مجموعة من الإعدادات البديلة.

الإعداداتجدول التعرفةالكمية المتوقعةكمية الفوترةالرسوم
الإعداداتالتعرفات الأساسية للرموزجدول التعرفةالتعرفة الأساسيةالكمية المتوقعة—كمية الفوترة—الرسوم
الإدخال · رموز الإدخال · تقدير للمقارنة فقط — / 1K من الرموز
الإخراج · رموز الإخراج · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · قراءة ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت · تقدير للمقارنة فقط — / 1K من الرموز
الإدخال · الكتابة إلى ذاكرة التخزين المؤقت، 1 ساعة · تقدير للمقارنة فقط — / 1K من الرموز
الإعداداتلكل طلبجدول التعرفة—الكمية المتوقعة—كمية الفوترةطلب واحدالرسوم
الإدخال · تقدير للمقارنة فقط $0.2 لكل طلب
الإعداداتتكلفة التوليد التقديريةجدول التعرفة—الكمية المتوقعةتقدير لتوليد واحدكمية الفوترة—الرسوم
الإخراج · تكلفة التوليد التقديرية · تقدير للمقارنة فقط $0.2 تقدير قبل الإنشاء

هذا التقدير ليس رسومًا إضافية ولا تعرفة ثابتة لعملية التوليد المكتملة.

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

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

Ailoot Ultra · Music

curl · أنشئ مرة واحدة واحتفظ بإيصال العمليةاقرأ المهمة الأصليةاحفظ كل أصل رقمي مكتمل تملكه
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
cat > request.json <<'JSON'
{
  "model": "suno-api",
  "gpt_description_prompt": "古诗词",
  "mv": "chirp-crow",
  "make_instrumental": false
}
JSON
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
# Create once; retain id, polling_url, original task identifiers and every header.
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_STATUS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("result.json").read_text())
u=urljoin("https://api.ailoot.ai",r["polling_url"])
p=urlsplit(u)
if p.scheme!="https" or p.netloc!="api.ailoot.ai" or p.username or p.password:
    raise SystemExit("Unexpected returned polling URL; preserve the response")
subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-D","status-headers.txt","-o","status.json"],check=True)
# Read this same original polling_url again while pending.
# Preserve unknown/result_pending_check; do not repeat creation.
PY_STATUS
set -eu
: "${AILOOT_API_KEY:?Set your Ailoot API key}"
export AILOOT_API_KEY
python3 - <<'PY_ASSETS'
import json,os,subprocess
from pathlib import Path
from urllib.parse import urljoin,urlsplit
r=json.loads(Path("status.json").read_text())
roles={}
def visit(v,path=""):
    if isinstance(v,dict):
        for k,x in v.items(): visit(x,path+"/"+k)
    elif isinstance(v,list):
        for i,x in enumerate(v): visit(x,path+"/"+str(i))
    elif isinstance(v,str):
        u=urljoin("https://api.ailoot.ai",v); p=urlsplit(u)
        if p.scheme=="https" and p.netloc=="api.ailoot.ai" and not p.username and not p.password and p.path.startswith("/v1/media/assets/") and p.path.endswith("/content"):
            roles.setdefault(u,[]).append(path)
visit(r)
if not roles: raise SystemExit("No completed owned assets; retain the original status")
manifest=[]
for i,(u,paths) in enumerate(roles.items()):
    target=Path(f"asset-{i}.bin")
    subprocess.run(["curl","--fail-with-body","--silent","--show-error",u,"-H","Authorization: Bearer "+os.environ["AILOOT_API_KEY"],"-o",str(target)],check=True)
    raw=target.read_bytes()
    if not raw: raise SystemExit("Empty asset; retain original status and metadata")
    ext="glb" if raw[:4]==b"glTF" else "png" if raw[:8]==b"\x89PNG\r\n\x1a\n" else "jpg" if raw[:3]==b"\xff\xd8\xff" else "webp" if raw[:4]==b"RIFF" and raw[8:12]==b"WEBP" else "mp4" if raw[4:8]==b"ftyp" else "bin"
    name=f"asset-{i}.{ext}"
    if target.name!=name: target.rename(name)
    manifest.append({"file":name,"response_paths":paths,"bytes":len(raw)})
Path("asset-manifest.json").write_text(json.dumps(manifest,indent=2))
print("Saved",len(manifest),"unique owned assets; every response role retained")
PY_ASSETS

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

Ailoot Ultra · Music

نزّل كل صورة مُرجعة أو احفظ محتواها بصيغة Base64

  • GET /v1/music/generations/{request_id}
  • GET /v1/media/assets
  • GET /v1/media/assets/{asset_id}
الاحتفاظ بكل النتائج المكتملة

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

احتفظ بالاستجابة والترويسات كاملة، والمعرّفات الأصلية، وكل مخرج فعلي، وجميع حقول الاستخدام والمحاسبة. احفظ كل أصل فريد مملوك لك، واحتفظ بكل دور يشير إليه.

عند الحاجة إلى التحقق من الاستجابة الأصلية

احتفظ بالمعرّف العام المُعاد للمهمة أو العملية وبجميع الترويسات. اقرأ المهمة الأصلية فقط؛ فالحالة unknown أو result_pending_check لا تمنح الإذن بإنشاء مهمة أخرى.

حقول الاستجابة
الحقلالنوع
الحقلidالنوعstring
الحقلpolling_urlالنوعstring
الحقلprovider_task_idالنوعstring
الحقلdata.task_idالنوعstring
الحقلdata.statusالنوعstring
الحقلdata.data[].audio_urlالنوعstring
الحقلdata.data[].image_urlالنوعstring
الحقلdata.data[].image_large_urlالنوعstring
الحقلdata.data[].video_urlالنوعstring

الأسماء البديلة

الأسماء البديلة للنموذج

Ailoot Ultra suno-api

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

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

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

suno-api

FAQ · suno-api
ما المدخلات والنتائج المتاحة؟

POST /v1/music/generations · suno-api: text → audio, image, video

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

POST /v1/music/generations · suno-api: model, gpt_description_prompt, mv, make_instrumental

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

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

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

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

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

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

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

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

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

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

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

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