استخدم Suno Sounds عبر Rivya Public API v1 مع معرف النموذج suno-sounds، والمدخلات المدعومة، والمعلمات، وقواعد Files API، والرصيد، وأمثلة الاستجابة.

متاح عبر APIإدخال النص جاهزصوت

معرف نموذج API

suno-sounds

المدخلات

text

Files API

غير مطلوب للطلب الأدنى

الرصيد الأساسي

القدرة

صوت

الفوترة

FIXED

حد prompt

500 أحرف

عقد الطلب

أرسل معرف النموذج في المستوى الأعلى. توضع عناصر التحكم الخاصة بالنموذج داخل params.

المفتاح	النوع	مطلوب	الافتراضي	الوصف
model	string	نعم	suno-sounds	استخدم معرف نموذج API وهو suno-sounds.
prompt	string	نعم	-	الحد الأقصى لهذا النموذج هو 500 حرفا.
params	object	لا	-	كائن معلمات خاص بالنموذج. استخدم الصفوف أدناه لمعرفة المفاتيح المسموح بها.
client_request_id	string	لا	-	معرف اختياري من جهة العميل لتتبع الطلبات في نظامك.

معلمات النموذج

المفتاح	النوع	مطلوب	الافتراضي	النطاق	الخيارات	الوصف
model	select	لا	V5	-	V5, V5_5	يحدد عائلة توليد Suno التي يجب استخدامها. غالبا ما تتعامل الإصدارات الأحدث مع الأسلوب والتفاصيل بصورة أفضل، لكنها قد تختلف في التكلفة والسلوك.
soundLoop	select	لا	false	-	false, true	تشغيل loop
soundTempo	number	لا	-	min 1 / max 300 / step 1	-	يضبط الإيقاع بعدد النبضات في الدقيقة. القيم الأعلى تشعر عادة بسرعة أكبر وتكون أكثر فائدة لتصميم الصوت الإيقاعي.
soundKey	select	لا	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B	يضبط المفتاح الموسيقي. حدده فقط عندما تحتاج النتيجة إلى مطابقة هارموني أو لحن موجود؛ وإلا فإن تركه واسعا يكون عادة أكثر أمانا.

الطلب الأدنى

{
  "model": "suno-sounds",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

استجابة الإنشاء

يعيد endpoint الإنشاء معرف مهمة عاما. استعلم عن endpoint الحالة حتى تنجح المهمة أو تفشل.

{
  "id": "task_suno_sounds_example",
  "status": "queued",
  "model": "suno-sounds",
  "reserved_credits": 3,
  "final_credits": 0,
  "created_at": "2026-05-11T00:00:00.000Z",
  "updated_at": "2026-05-11T00:00:00.000Z",
  "result": null,
  "error": null
}

الأخطاء الشائعة

validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found