ما الفرق بين auto_lyrics وexact_lyrics وinstrumental؟

يولّد auto_lyrics كلمات الأغنية من نصك الوصفي — تصف الأغنية وتكتب Suno الكلمات. أما exact_lyrics فيستخدم الكلمات التي تقدمها حرفياً، ويتطلب حقلَي style وtitle. وinstrumental يُنتج مقطوعة بلا أصوات بشرية باستخدام الأسلوب والعنوان فقط.

أيّ إصدار Suno يجب استخدامه؟

suno-v5.5 هو الأحدث ويُنتج أعلى جودة مع وضوح صوتي ومزج أفضل. suno-v4 وsuno-v4.5 أرخص وأسرع للمسودات الأولية. جميع الإصدارات تستخدم نفس نقطة نهاية text_to_music والمعاملات ذاتها.

كم يستغرق توليد Suno؟

يتفاوت وقت التوليد حسب الإصدار وطول الأغنية. المدة المعتادة من 30 ثانية إلى دقيقتين. تُعيد الواجهة البرمجية task_id فوراً — استطلع نقطة نهاية الحالة أو عيّن callback_url لتجنب تعليق عميلك.

هل توفر RunAPI واجهة برمجية رسمية لـ Suno؟

لا تمتلك Suno واجهة برمجية عامة رسمية. توفر RunAPI وصولاً برمجياً إلى Suno من الإصدار v4 حتى v5.5 بنفس مفتاح API ودورة حياة المهام المستخدمة في جميع نماذج RunAPI. لا حاجة لحساب Suno أو بيانات اعتماد منفصلة.

هل يمكنني التحكم في جنس الصوت ووزن الأسلوب؟

نعم. عيّن vocal_gender إلى male أو female. استخدم negative_tags لاستبعاد الأساليب غير المرغوبة. لمزيد من الدقة، أنشئ شخصية عبر نقطة نهاية generate_persona ومرّر persona_id المُعاد مع persona_type محدداً بـ voice أو style.

OPENCLAW + SUNO

استخدم Suno في OpenClaw.

يُنشئ Suno أغانٍ كاملة — أصوات بشرية وآلات موسيقية ومزج صوتي — من نص وصفي أو كلمات محددة. الإصدارات من v4 حتى v5.5 متاحة عبر RunAPI، إذ لا تمتلك Suno واجهة برمجية عامة رسمية. تستدعيها عملاء OpenClaw بنفس مفتاح RUNAPI_API_KEY المستخدم للدردشة.

احصل على API Key اقرأ الوثائق

مفتاح API واحد · نقطة نهاية text_to_music · استطلاع مهام غير متزامن

Use RunAPI to generate a song with Suno.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- Call POST https://runapi.ai/api/v1/suno/text_to_music
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" for AI-generated lyrics from a prompt.
- Set prompt to describe the song you want.
- The task is async. Poll the returned task_id until status is "completed".
- When done, read the audio URL from the response output.

curl -X POST https://runapi.ai/api/v1/suno/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v5.5",
    "vocal_mode": "auto_lyrics",
    "prompt": "An upbeat indie pop track about coding late at night, warm synths and acoustic guitar",
    "vocal_gender": "female"
  }'

{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

انسخ أمر curl للاختبار suno

HOW IT WORKS

استخدم Suno في OpenClaw في ثلاث خطوات

تهيئة RunAPI

عيّن RUNAPI_API_KEY في بيئتك. إن كنت قد هيّأت RunAPI في OpenClaw للدردشة مسبقاً، فالمفتاح ذاته يعمل مع توليد الموسيقى بـ Suno دون الحاجة لإعداد مزوّد إضافي.

export RUNAPI_API_KEY=runapi_xxx

استدعاء text_to_music

أرسل طلب POST إلى نقطة نهاية text_to_music مع تحديد النموذج والوضع الصوتي. استخدم auto_lyrics مع نص وصفي لكتابة كلمات الأغنية بالذكاء الاصطناعي، أو exact_lyrics مع الكلمات والأسلوب والعنوان لكلماتك الخاصة، أو instrumental مع الأسلوب والعنوان لمقطوعة بلا أصوات بشرية.

POST /api/v1/suno/text_to_music

استطلاع النتيجة

تُعيد نقطة النهاية task_id فوراً. يستغرق توليد الأغنية من 30 ثانية إلى عدة دقائق حسب الإصدار. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة "completed"، ثم اقرأ رابط الصوت من الاستجابة.

GET /api/v1/suno/text_to_music/tsk_abc123

PARAMETERS

معاملات واجهة برمجة Suno text_to_music

المعامل	النوع	الوصف
`model`	`string`	مطلوب. suno-v4 أو suno-v4.5 أو suno-v4.5-all أو suno-v4.5-plus أو suno-v5 أو suno-v5.5.
`vocal_mode`	`string`	مطلوب. auto_lyrics (الذكاء الاصطناعي يكتب الكلمات من النص الوصفي)، أو exact_lyrics (تُقدّم أنت الكلمات والأسلوب والعنوان)، أو instrumental (بلا أصوات بشرية، يتطلب الأسلوب والعنوان).
`prompt`	`string`	وصف موجز للأغنية في وضع auto_lyrics. صف النوع الموسيقي والمزاج والإيقاع والموضوع. محظور في وضعَي exact_lyrics وinstrumental.
`lyrics`	`string`	الكلمات الحرفية للغناء. مطلوب في وضع exact_lyrics. محظور في وضعَي auto_lyrics وinstrumental.
`style`	`string`	وصف الأسلوب الموسيقي، مثل lo-fi hip hop أو 80s synthwave. مطلوب في وضعَي exact_lyrics وinstrumental.
`title`	`string`	عنوان الأغنية. مطلوب في وضعَي exact_lyrics وinstrumental.
`vocal_gender`	`string`	اختياري. male أو female.
`negative_tags`	`string`	اختياري. الأساليب المراد تجنبها، مثل heavy metal أو screaming.
`duration_seconds`	`integer`	اختياري. المدة المستهدفة بالثواني.
`persona_id`	`string`	اختياري. معرّف الشخصية لملفات تعريف الصوت أو الأسلوب المخصصة.
`persona_type`	`string`	اختياري. style أو voice. يحدد فئة الشخصية.
`callback_url`	`string`	اختياري. رابط webhook يستقبل طلب POST عند اكتمال المهمة.

ما هو Suno في OpenClaw؟

Suno ذكاء اصطناعي لتحويل النص إلى موسيقى يُنشئ أغاني كاملة — أصوات وآلات موسيقية وإنتاج — من نص توجيهي. يدعم وضع الكلمات الدقيقة والتوليد المستمر للأغاني الأطول والتأليف الموجّه بالنوع. تستدعيه وكلاء OpenClaw عبر RunAPI بنفس مفتاح API المستخدم للمحادثة.