It looks like you may prefer a different language. Switch anytime.

Suno · Audio & Music

OpenClaw x Suno

Suno is an AI music generation platform that creates original songs — vocals, instruments, and lyrics — from text descriptions. Through RunAPI, all Suno versions share a single API key with per-call billing.

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

Prerequisite: npx runapi mcp install

Prompt

نماذج Prompt

استخدم suno-v4 عندما يناسب المهمة: Improved coherence and frequency range, 4-min cap.

You have access to RunAPI task tools for Suno.

Available Suno models:
- suno-v4: Improved coherence and frequency range, 4-min cap
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/extend_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/create_mashup
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5: 8-min first-generation, 25% fewer genre errors, 40% better vocals
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/extend_music, /api/v1/suno/cover_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/create_mashup
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v4.5-all: All v4.5 styles and modes unlocked without subscription gating
  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
- suno-v4.5-plus: Enhanced quality tier within the v4.5 architecture
  endpoints: /api/v1/suno/stitch_audio, /api/v1/suno/cover_audio, /api/v1/suno/add_samples, /api/v1/suno/remaster_audio, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5: CD-quality audio, up to 8 min per generation
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/stitch_audio, /api/v1/suno/remaster_audio, /api/v1/suno/text_to_sound, /api/v1/suno/add_samples, /api/v1/suno/inspire_music, /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/create_mashup, /api/v1/suno/add_instrumental, /api/v1/suno/add_vocals
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v5.5: Up to 8 min per generation, voice cloning and style training
  endpoints: /api/v1/suno/cover_audio, /api/v1/suno/text_to_sound, /api/v1/suno/stitch_audio, /api/v1/suno/remaster_audio, /api/v1/suno/add_samples, /api/v1/suno/create_mashup, /api/v1/suno/text_to_music, /api/v1/suno/inspire_music, /api/v1/suno/extend_music, /api/v1/suno/add_instrumental
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6: suno-v6
  endpoints: /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/cover_audio, /api/v1/suno/create_mashup
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-mini: suno-v6-mini
  endpoints: /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/cover_audio, /api/v1/suno/create_mashup
  request fields: model, vocal_mode, prompt, persona_id, persona_type
- suno-v6-wild: suno-v6-wild
  endpoints: /api/v1/suno/text_to_music, /api/v1/suno/extend_music, /api/v1/suno/cover_audio, /api/v1/suno/create_mashup
  request fields: model, vocal_mode, prompt, persona_id, persona_type

Use the model ID and endpoint that match the user's request.
Example prompt: Write a lo-fi chill beat with soft piano, vinyl crackle, and a gentle bass line, 2 minutes long.
/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/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_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/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/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/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_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/remaster_audio /api/v1/suno/add_samples /api/v1/suno/extend_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/create_mashup
$0.010 تفاصيل النموذج
suno-v4.5
/api/v1/suno/stitch_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/extend_music /api/v1/suno/cover_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/create_mashup
$0.010 تفاصيل النموذج
suno-v4.5-all
/api/v1/suno/create_mashup /api/v1/suno/cover_audio /api/v1/suno/text_to_music /api/v1/suno/extend_music
$0.120 تفاصيل النموذج
suno-v4.5-plus
/api/v1/suno/stitch_audio /api/v1/suno/cover_audio /api/v1/suno/add_samples /api/v1/suno/remaster_audio /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.010 تفاصيل النموذج
suno-v5
/api/v1/suno/cover_audio /api/v1/suno/stitch_audio /api/v1/suno/remaster_audio /api/v1/suno/text_to_sound /api/v1/suno/add_samples /api/v1/suno/inspire_music /api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/create_mashup /api/v1/suno/add_instrumental /api/v1/suno/add_vocals
$0.010 تفاصيل النموذج
suno-v5.5
/api/v1/suno/cover_audio /api/v1/suno/text_to_sound /api/v1/suno/stitch_audio /api/v1/suno/remaster_audio /api/v1/suno/add_samples /api/v1/suno/create_mashup /api/v1/suno/text_to_music /api/v1/suno/inspire_music /api/v1/suno/extend_music /api/v1/suno/add_instrumental
$0.010 تفاصيل النموذج
suno-v6
/api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/cover_audio /api/v1/suno/create_mashup
$0.120 تفاصيل النموذج
suno-v6-mini
/api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/cover_audio /api/v1/suno/create_mashup
$0.120 تفاصيل النموذج
suno-v6-wild
/api/v1/suno/text_to_music /api/v1/suno/extend_music /api/v1/suno/cover_audio /api/v1/suno/create_mashup
$0.120 تفاصيل النموذج

التحقق

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

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

الإعداد

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

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

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

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

  • /api/v1/suno/generate_artwork
  • /api/v1/suno/separate_audio_stems
  • /api/v1/suno/regenerate_validation_phrase
  • /api/v1/suno/generate_persona
  • /api/v1/suno/boost_style
  • /api/v1/suno/check_voice
  • /api/v1/suno/generate_midi
  • /api/v1/suno/get_timestamped_lyrics
  • /api/v1/suno/generate_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

  • فيديوهات عروض المنتجات

    أنشئ رسومًا متحركة للمنتجات مدتها من 5 إلى 10 ثوانٍ من أوصاف نصية، وهي مناسبة للتجارة الإلكترونية والإعلانات الاجتماعية.

  • محتوى الصور الرمزية بالذكاء الاصطناعي

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

  • إنتاج الفيديو على دفعات

    ضع مئات من عمليات إنشاء الفيديو في قائمة الانتظار واستلم النتائج عبر webhook.

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

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

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

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

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

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

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

أسئلة حول OpenClaw وSuno

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

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

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

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

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

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

تواصل معنا