suno-api
ينشئ Suno موسيقى من فكرة مكتوبة قصيرة. يُنتج مسار العمل التلقائي الموثّق أغنيتين، ويتضمن خيارًا للموسيقى الآلية، ويعيد الصوت المكتمل والبيانات الوصفية للمقاطع عبر مهمة التوليد.
عن النموذج
يغطي هذا الوصف قدرات النموذج. وترد أدناه المدخلات والمخرجات والخيارات المتاحة في Ailoot للطريقة المحددة.
Suno خدمة لتوليد الموسيقى تحوّل فكرة مكتوبة إلى أغانٍ. يقبل مسار العمل التلقائي الموثّق وصفًا قصيرًا للموسيقى المقصودة واختيارًا للموسيقى الآلية، ثم يولّد أغنيتين. استخدم الوصف لتحديد الموضوع والأجواء والتوجه الموسيقي الذي تريد سماعه في المقاطع المكتملة.
ابدأ بالدور الذي ينبغي أن تؤديه الموسيقى. فخلفية هادئة لشرح، أو افتتاحية حيوية لفيديو قصير، أو أغنية تأملية عن رحلة، يمنح كل منها الوصف غرضًا ملموسًا. صِف الأجواء المقصودة والسمات الموسيقية المهمة لذلك الغرض في بضع عبارات واضحة.
في أغنية تتضمن غناءً، اجعل الموضوع واللغة واضحين في الموجز الإبداعي. صِف الفكرة التي ينبغي أن يعبّر عنها المقطع، والنبرة التي ينبغي أن ينقلها الأداء. استمع إلى النتيجة المكتملة لتقييم تكامل الغناء والكلمات والتوزيع الموسيقي. احتفظ بمعلومات المقطع الناتجة إلى جانب الصوت للمراجعة.
للحصول على موسيقى آلية، استخدم خيار الموسيقى الآلية الموثّق، وصِف التوجه الموسيقي في النص. حدّد الأجواء المطلوبة والآلات البارزة عندما تكون مهمة للمشروع. راجع المقطع المكتمل وفق الموضع الذي سيشغله في المونتاج، بما في ذلك الأجزاء التي ينبغي أن ترافق الكلام في الخلفية أو تدعم انتقالًا بصريًا.
يُنتج مسار العمل التلقائي أغنيتين من الفكرة المقدّمة. تعامل معهما بوصفهما خيارين مرشحين منفصلين، واحتفظ بكلا الملفين الصوتيين المكتملين. استمع إلى كل منهما من البداية، مرورًا بالتطور، وصولًا إلى النهاية. قارن المقاطع الفعلية بالغرض نفسه، بما يشمل أجواءها وتوزيعها الموسيقي وملاءمتها للاستخدام المخطّط له.
يُنظَّم التوليد على هيئة مهمة. احتفظ بمعرّف المهمة المُعاد أثناء التحقّق من نتيجتها، وميّز المقاطع المكتملة من العناصر التي لا تزال قيد التنفيذ. تتضمن النتيجة الموثّقة معلومات على مستوى المقطع، مثل العنوان والحالة وموقع الملف الصوتي والمدة. احفظ الصوت المكتمل نفسه مع البيانات الوصفية المتاحة والوصف الأصلي.
في فيديو أو عرض تقديمي، جرّب الموسيقى المختارة مع المادة الفعلية. تحقّق من البداية والانتقالات والنهاية عند مستوى الصوت المقصود. حدّد الجزء الذي يخدم المونتاج، واحتفظ بالمقطع كاملًا للتغييرات اللاحقة. يُقيَّم المقتطف الموسيقي المناسب في سياق الصوت والصور وإيقاع العمل المكتمل.
احتفظ بالفكرة المكتوبة، وخيار الموسيقى الآلية، واختيار النموذج، وجميع المقاطع المكتملة معًا. عندما يحتاج مقطع مرشح إلى مراجعة، حدّد وجه عدم التوافق الموسيقي، مثل توزيع موسيقي مزدحم أكثر من اللازم خلف الكلام أو مقدمة تتطور ببطء مفرط. حافظ على التوجه المفيد، وعدّل الجزء من الوصف المرتبط بتلك المشكلة.
Ailoot Ultra · Music POST /v1/music/generations suno-api
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
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/assetsGET /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
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