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

OpenClaw x Suno

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

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

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 إلى حالة نهائية.

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

  • موسيقى خلفية لـ YouTube ووسائل التواصل الاجتماعي

    أنشئ مقاطع موسيقية خلفية أصلية للفيديوهات بوصف الأجواء والنوع الموسيقي في الأمر.

  • سماع كلمات الأغنية كأغنية كاملة

    يستطيع كتّاب الأغاني تقديم كلماتهم مع وصف للأسلوب وسماعها مؤدّاة كنسخة تجريبية كاملة قبل دخول الاستوديو.

  • مقدمات وخواتيم البودكاست

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

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

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

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

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

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

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

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

أسئلة حول OpenClaw وSuno

كيف أكتب أوامر أفضل لـ Suno؟

كن محددًا في النوع الموسيقي والأجواء والإيقاع والآلات. أمر مثل «بوب مستقل مرح مع غيتار صوتي وسنثات دافئة» يعطي نتيجة أفضل من «أغنية سعيدة».

هل يمكنني تمديد أغنية Suno بعد المقطع الأول؟

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

هل أحتاج إلى حساب Suno لاستخدامه عبر RunAPI؟

لا. يوفّر RunAPI وصولًا برمجيًا إلى Suno باستخدام مفتاح RunAPI API ورصيدك، دون حاجة إلى حساب Suno أو بيانات اعتماد منفصلة.

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

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

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

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

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

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

تواصل معنا