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

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

كيف أهيّئ RunAPI كمزوّد مخصص في Hermes Agent لاستخدام Suno؟

أضف مزوّد custom:runapi في إعدادات Hermes Agent مع تعيين base_url إلى https://runapi.ai/v1 وapi_key يقرأ من RUNAPI_API_KEY. يعالج المزوّد ذاته طلبات الدردشة والصور والفيديو والموسيقى — لا حاجة لإعداد منفصل لـ Suno.

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

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

هل يمكنني توليد مقطوعات آلية بلا أصوات بشرية؟

نعم. عيّن vocal_mode إلى instrumental وقدّم حقلَي style وtitle. يجب حذف حقلَي prompt وlyrics في وضع instrumental. تُطبّق الواجهة البرمجية هذه القواعد عبر الحقول وترجع خطأ تحقق عند إرسال حقول متعارضة.

ما نقاط نهاية Suno الأخرى المتاحة بجانب text_to_music؟

تُتيح RunAPI cover_audio (لإعادة أسلوب مسار موجود)، وextend_music (لمتابعة أغنية من لحظة زمنية محددة)، وcreate_mashup (لدمج عناصر من مسارات متعددة)، وtext_to_sound (للمؤثرات الصوتية)، ونقاط نهاية مساعدة مثل generate_lyrics وgenerate_persona وseparate_audio_stems. جميعها تشترك في مفتاح API ودورة حياة المهام ذاتها.

HERMES + SUNO

استخدم Suno في Hermes Agent.

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

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

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

Use RunAPI to generate a song with Suno.

Requirements:
- Read the API key from RUNAPI_API_KEY.
- Use the custom:runapi provider with base_url https://runapi.ai/v1.
- 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 في Hermes Agent في ثلاث خطوات

تهيئة RunAPI

عيّن RUNAPI_API_KEY في البيئة التي يعمل فيها Hermes Agent. إن كنت قد أضفت RunAPI مسبقاً كمزوّد custom:runapi، فالمفتاح وbase_url ذاتهما يعالجان طلبات موسيقى 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 في Hermes Agent؟

Suno مولّد نص إلى موسيقى ينتج أغاني كاملة بأصوات وآلات موسيقية وإنتاج. يستدعيه Hermes Agent عبر RunAPI custom provider لخطوات توليد الموسيقى في خطوط أنابيب المحتوى الآلية.