Suno · صوت وموسيقى

Hermes Agent x Suno

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

9 variants ابتداءً من $0.01 / استدعاء مسموح للاستخدام التجاري
احصل على مفتاح API عرض توثيق Hermes Agent

Prerequisite: npx runapi mcp install

Prompt

نماذج Prompt

استخدم suno-v4 عندما يناسب المهمة: تماسك ونطاق ترددي محسّنان، بحد أقصى 4 دقائق.

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: تماسك ونطاق ترددي محسّنان، بحد أقصى 4 دقائق
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_samples, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: حتى 8 دقائق في التوليد الأول، وأخطاء أقل في النوع الموسيقي بنسبة 25%، وغناء أفضل بنسبة 40%
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/create_mashup, /api/v1/suno/extend_music, /api/v1/suno/add_samples, /api/v1/suno/stitch_audio, /api/v1/suno/inspire_music, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: جميع أساليب v4.5 وأوضاعه متاحة دون قيود اشتراك
  endpoints: /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-plus: مستوى جودة محسّن ضمن معمارية v4.5
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: صوت بجودة CD، حتى 8 دقائق لكل عملية توليد
  endpoints: /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/add_instrumental, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: حتى 8 دقائق لكل عملية توليد، مع استنساخ الصوت وتدريب الأسلوب
  endpoints: /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/stitch_audio, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental, /api/v1/suno/remaster_audio
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/cover_audio, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/create_mashup, /api/v1/suno/cover_audio, /api/v1/suno/text_to_music, /api/v1/suno/extend_music
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: اكتب إيقاع lo-fi هادئًا مع بيانو ناعم وطقطقة أسطوانة فينيل وخط باص لطيف، بطول دقيقتين.
/api/v1/suno/stitch_audio: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/stitch_audio واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/stitch_audio/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/extend_music: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/extend_music واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/extend_music/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/create_mashup: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/create_mashup واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/create_mashup/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/add_samples: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/add_samples واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/add_samples/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/cover_audio: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/cover_audio واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/cover_audio/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/inspire_music: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/inspire_music واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/inspire_music/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/text_to_music: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/text_to_music واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/text_to_music/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/remaster_audio: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/remaster_audio واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/remaster_audio/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/add_instrumental: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/add_instrumental واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/add_instrumental/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/add_vocals: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/add_vocals واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/add_vocals/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.
/api/v1/suno/text_to_sound: Submit the task, poll for its status, then verify the completed output. أرسل POST إلى /api/v1/suno/text_to_sound واحفظ معرّف Task المُعاد.
أرسل GET إلى /api/v1/suno/text_to_sound/<task-id> حتى تصبح الحالة completed أو failed.
تحقق من أن استجابة completed تحتوي على المخرجات الخاصة بنقطة النهاية والموثقة في مرجع API.

الإصدارات ونقاط النهاية العامة

Suno V6 متاح الآن. الطلبات التي تستخدم معرّفات النماذج القديمة (v3.5–v5.5) يتم توجيهها تلقائيًا إلى V6 أو V6 Mini. الأسعار لم تتغير.
معرّف النموذج نقاط النهاية السعر الابتدائي الكتالوج
suno-v4
/api/v1/suno/stitch_audio /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_samples /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/remaster_audio
$0.01 / استدعاء تفاصيل النموذج
suno-v4.5
/api/v1/suno/remaster_audio /api/v1/suno/create_mashup /api/v1/suno/extend_music /api/v1/suno/add_samples /api/v1/suno/stitch_audio /api/v1/suno/inspire_music /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.01 / استدعاء تفاصيل النموذج
suno-v4.5-all
/api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music
$0.12 / استدعاء تفاصيل النموذج
suno-v4.5-plus
/api/v1/suno/cover_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.01 / استدعاء تفاصيل النموذج
suno-v5
/api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/add_instrumental /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/add_vocals
$0.01 / استدعاء تفاصيل النموذج
suno-v5.5
/api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/stitch_audio /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental /api/v1/suno/remaster_audio
$0.01 / استدعاء تفاصيل النموذج
suno-v6
/api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/cover_audio /api/v1/suno/extend_music
$0.12 / استدعاء تفاصيل النموذج
suno-v6-mini
/api/v1/suno/cover_audio /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / استدعاء تفاصيل النموذج
suno-v6-wild
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.12 / استدعاء تفاصيل النموذج

التحقق

استعلم حتى تصل المهمة إلى حالة نهائية

اختر <model-id> لإنشاء أوامر التحقق.

الإعداد

نقطة نهاية الدليل: <endpoint>

اختر <model-id> لإنشاء طلب وفق عقد الإدخال العام لنقطة النهاية.

عمليات إضافية

لا تستخدم هذه العمليات معرّف نموذج.

  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/generate_artwork
  • /api/v1/suno/generate_persona
  • /api/v1/suno/generate_midi
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_voice
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/voice_to_validation_phrase
  • /api/v1/suno/convert_audio
  • /api/v1/suno/visualize_music
  • /api/v1/suno/generate_lyrics
  • /api/v1/suno/blend_lyrics
  • /api/v1/suno/replace_section
آلية العمل

ابدأ في 3 خطوات

  1. اختر معرّف نموذج

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

  2. اضبط RunAPI

    اضبط RUNAPI_API_KEY قبل إرسال الطلب إلى نقطة النهاية.

  3. تحقق من النتيجة

    لنقاط النهاية غير المتزامنة، استعلم من نقطة النهاية نفسها حتى تصل Task إلى حالة نهائية.

ما الذي يمكنك بناؤه باستخدام Hermes Agent + Suno

  • دفتر مسودات لكتابة الأغاني

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

  • نسخ جديدة بأساليب مختلفة

    أعد تنميق مقطوعة موجودة بتغيير نوعها الموسيقي أو آلاتها أو أجوائها مع الحفاظ على اللحن والبنية.

  • مسارات سمعية بصرية متكاملة

    اربط Suno بنماذج الفيديو في سير عمل Hermes Agent لإنشاء لقطات وموسيقى أصلية مناسبة لها.

لماذا تستخدم Suno عبر RunAPI + Hermes Agent

  • 9 نماذج، ومفتاح API واحد

    استخدم اتصالاً واحداً مع RunAPI للاختيار بين نماذج متاحة من دون تغيير تكاملك.

  • أسعار استخدام واضحة

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

  • سير عمل تلقائي للمهام

    أرسل المهام غير المتزامنة واستعلم عن حالتها واجمع نتائجها عبر سير عمل موحّد من دون كتابة كود استطلاع يدوي.

أسئلة حول Hermes Agent وSuno

كيف أعدّ Suno في Hermes Agent؟

استخدم مزوّد RunAPI نفسه الذي أعددته للدردشة. فهو يخدم نقاط نهاية الدردشة والصور والفيديو والموسيقى، لذلك لا يحتاج Suno إلى إعداد منفصل.

هل يمكنني إنشاء مقطوعات آلية دون غناء؟

نعم. يدعم Suno التوليد الآلي. توضّح معاملات الطلب في هذه الصفحة الحقول المطبّقة في الوضع الآلي، وتعيد الواجهة البرمجية خطأ تحقق إذا أُرسلت حقول متعارضة.

هل يستطيع Hermes Agent ربط Suno بنماذج الفيديو؟

نعم. يستطيع Hermes Agent إنشاء فيديو بنموذج فيديو، ثم إنشاء موسيقى مناسبة له باستخدام Suno في سير العمل نفسه.

أي معرّف نموذج أستخدم؟

اختر معرّف نموذج عامًا من جدول الإصدارات. يعرض كل معرّف نقاط النهاية الموضحة في صفه.

هل يضبط هذا الدليل نموذج محادثة؟

لا. يستخدم Model Line هذا مسار نقطة النهاية الموضح هنا ولا يُعرض كنموذج محادثة للوكيل.

هل تبنون مع فريق؟

نساعدكم في إعدادات المؤسسات والتكاملات والأسئلة التقنية.

تواصل معنا