---
title: استخدم Suno في WorkBuddy عبر RunAPI — دليل Music MCP | RunAPI
description: ولّد أغاني باستخدام Suno من الإصدار v4 إلى v5.5 في WorkBuddy عبر خادم MCP الخاص بـ RunAPI. مفتاح واحد، وأوضاع صوتية، واستطلاع غير متزامن يتولاه وكيل المنضدة.
url: https://runapi.ai/ar/workbuddy-suno.md
canonical: https://runapi.ai/ar/workbuddy-suno
locale: ar
site: RunAPI
image: https://runapi.ai/assets/opengraph-bfaaa0f0.png
alternates:
  en: https://runapi.ai/workbuddy-suno
  zh-CN: https://runapi.ai/zh-CN/workbuddy-suno
  es: https://runapi.ai/es/workbuddy-suno
  ja: https://runapi.ai/ja/workbuddy-suno
  de: https://runapi.ai/de/workbuddy-suno
  fr: https://runapi.ai/fr/workbuddy-suno
  pt-BR: https://runapi.ai/pt-BR/workbuddy-suno
  ko: https://runapi.ai/ko/workbuddy-suno
  it: https://runapi.ai/it/workbuddy-suno
  nl: https://runapi.ai/nl/workbuddy-suno
  pl: https://runapi.ai/pl/workbuddy-suno
  tr: https://runapi.ai/tr/workbuddy-suno
  zh-TW: https://runapi.ai/zh-TW/workbuddy-suno
  zh-HK: https://runapi.ai/zh-HK/workbuddy-suno
  ar: https://runapi.ai/ar/workbuddy-suno
  x-default: https://runapi.ai/workbuddy-suno
model: suno
---

> HTML version: https://runapi.ai/ar/workbuddy-suno
> Site index for agents: https://runapi.ai/llms.txt


# استخدم Suno في WorkBuddy.

تُولّد Suno أغاني كاملة — أصوات بشرية وآلات موسيقية وميكساج — من نص أو كلمات محددة. الإصدارات من v4 إلى v5.5 متاحة عبر RunAPI الذي يوفر وصول API نظراً لعدم وجود API عام رسمي لـ Suno. أضف RunAPI كخادم MCP مرةً واحدة، ويتولى وكيل WorkBuddy المهمة غير المتزامنة ويُعيد رابط الصوت النهائي.

- [احصل على API Key](https://runapi.ai/ar/login)
- [اقرأ الوثائق](https://runapi.ai/ar/docs/guides)

خادم MCP واحد · أغاني كاملة من نص · استطلاع غير متزامن مُدار

### الموجّه

```text
Using the runapi MCP server, generate a song with Suno.

Requirements:
- Call the Suno text_to_music tool exposed by the runapi MCP server.
- Set model to "suno-v5.5".
- Set vocal_mode to "auto_lyrics" so the lyrics are written from my brief.
- Prompt: an upbeat indie pop track about coding late at night,
  warm synths and acoustic guitar, female vocals.
- The task is async — keep polling until the status is "completed",
  then give me the audio URL.

```

### إعداد MCP

```bash
{
  "mcp_servers": {
    "runapi": {
      "url": "https://runapi.ai/mcp",
      "transport": "streamable_http",
      "headers": {
        "Authorization": "Bearer $RUNAPI_API_KEY"
      }
    }
  }
}

```

### الاستجابة

```json
{
  "task_id": "tsk_abc123",
  "status": "completed",
  "model": "suno-v5.5",
  "output": {
    "audio_url": "https://media.runapi.ai/outputs/tsk_abc123.mp3",
    "title": "Midnight Compile",
    "duration_seconds": 187
  }
}

```

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

1. **أضف RunAPI كخادم MCP** - عيّن RUNAPI_API_KEY في البيئة التي تُشغّل WorkBuddy، ثم سجّل خادم MCP باسم runapi يشير إلى https://runapi.ai/mcp عبر HTTP القابل للبث. تظهر Suno كأداة موسيقية قابلة للاستدعاء جنباً إلى جنب مع كل نماذج RunAPI الأخرى — دون الحاجة إلى ربط خدمة موسيقى منفصلة. `export RUNAPI_API_KEY=runapi_xxx
# MCP server: runapi → https://runapi.ai/mcp
`
2. **صِف الأغنية للوكيل** - أخبر WorkBuddy بما تريد بلغة طبيعية وحدد الوضع. استخدم auto_lyrics مع نص للكلمات المكتوبة بالذكاء الاصطناعي، أو exact_lyrics مع كلمات/أسلوب/عنوان لكلماتك الخاصة، أو instrumental مع أسلوب/عنوان بدون أصوات بشرية. يُحوّل الوكيل موجزك إلى استدعاء أداة Suno. `vocal_mode: auto_lyrics`
3. **دع الوكيل يستطلع ويجمع الصوت** - توليد الأغاني غير متزامن ويستغرق من 30 ثانية إلى عدة دقائق حسب الإصدار. يستطلع وكيل المنضدة المهمة حتى تكتمل، ثم يُرسل رابط الصوت الناتج إلى المحادثة — دون أن تتعامل مع task_id بنفسك. `"status": "completed"`

## معامِلات 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. |
| `vocal_gender` | `string` | اختياري. male أو female. |
| `negative_tags` | `string` | اختياري. أساليب يُراد تجنّبها، مثل heavy metal أو screaming. |

## ما هو Suno في WorkBuddy؟

Suno هو نموذج ذكاء اصطناعي لتحويل النص إلى موسيقى يُولّد أغاني كاملة -- بأصوات بشرية وآلات موسيقية وميكساج -- من نص أو كلماتك الخاصة. يعمل كمسودة كتابة أغاني حيث تصف النوع الموسيقي والمزاج والإيقاع وتحصل على مسار كامل. يصل إليه WorkBuddy عبر خادم MCP الخاص بـ RunAPI نظراً لعدم وجود API عام رسمي لـ Suno، مما يمنح وكيل المنضدة وصولاً برمجياً للإصدارات من v4 إلى v5.5 بنفس المفتاح المستخدم للمحادثة والصور.

## حالات استخدام Suno

- **موسيقى خلفية لـYouTube ووسائل التواصل الاجتماعي** - اطلب من وكيل المنضدة مسارات خلفية أصلية بوصف المزاج والنوع الموسيقي. لا رسوم ترخيص، لا مشكلات حقوق — المسار مُولَّد حديثاً لمحتواك ويصل الرابط إلى WorkBuddy.
- **سماع الكلمات كأغنية كاملة** - يمكن لكتّاب الكلمات لصق كلماتهم في WorkBuddy وطلب وضع exact_lyrics مع وصف الأسلوب، للاستماع إليها مُؤدَّاةً كأغنية كاملة — عرض تجريبي قبل وقت الاستوديو.
- **مقدمات وخواتم البودكاست** - أنشئ موسيقى مقدمة وخاتمة للبودكاست تتوافق مع نبرته بتحديد النوع والمزاج والمدة. اطلب من الوكيل توليد عدة نسخ في محادثة واحدة واختر الأنسب.

## أسئلة Suno + WorkBuddy

### كيف أكتب وصفاً أفضل لـSuno للحصول على النوع والأسلوب الموسيقي المطلوب؟

كن محدداً بشأن النوع الموسيقي والمزاج والإيقاع والآلات في موجزك لـ WorkBuddy. على سبيل المثال، "إيندي بوب نشيط بـ 120 BPM مع جيتار صوتي وسينث دافئ" أفضل من "أغنية سعيدة". اطلب من الوكيل تمرير negative_tags لاستبعاد عناصر غير مرغوبة كالميتال الثقيل أو الصراخ.

### أي إصدار Suno يجب أن أستخدم — v4 أو v5 أو v5.5؟

suno-v5.5 هو الأحدث ويُنتج أعلى جودة مع وضوح صوتي وميكساج أفضل. suno-v4 وsuno-v4.5 أرخص وأسرع للنسخ التجريبية. جميع الإصدارات خلف نفس خادم MCP باسم runapi، لذا يكفي تسمية إصدار مختلف في نصك.

### هل يجب أن أستطلع المهمة بنفسي في WorkBuddy؟

لا. مهام Suno غير متزامنة، لكن وكيل المنضدة يتولى دورة حياتها — يُنشئ المهمة عبر أداة MCP، ويستطلع حتى تكتمل، ويُرسل رابط الصوت إلى المحادثة. ما عليك سوى وصف الأغنية والانتظار.

### هل توفّر RunAPI API رسمياً لـSuno؟

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

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

نعم. اطلب vocal_gender ذكر أو أنثى، واستخدم negative_tags لاستبعاد الأساليب غير المرغوبة. للتحكم الدقيق، أنشئ شخصية عبر endpoint باسم personas ومرّر persona_id المُعاد مع ضبط persona_type على voice أو style.


- [دليل إعداد WorkBuddy →](https://runapi.ai/ar/workbuddy.md) - لم يتم الاتصال بعد؟ ابدأ بدليل إعداد RunAPI MCP لـ WorkBuddy.
- [Suno على RunAPI ←](https://runapi.ai/ar/models/suno.md) - استعرض جميع إصدارات Suno والأسعار والـendpoints المتاحة.

## جرّب Suno في WorkBuddy اليوم.

احصل على مفتاح RunAPI مجاني، أضف خادم MCP إلى WorkBuddy، وصِف أغنية — يُعيد وكيل المنضدة مساراً كاملاً بأصوات بشرية وآلات موسيقية وميكساج.

[تصفّح النماذج →](https://runapi.ai/ar/models.md)

---

## More from RunAPI

- [Home](https://runapi.ai/ar/.md)
### المنتج
- [كتالوج النماذج](https://runapi.ai/ar/models.md)
- [الأسعار](https://runapi.ai/ar/pricing.md)
- [مزودو الخدمة](https://runapi.ai/ar/models#all-models)
### المطورون
- [التوثيق](https://runapi.ai/ar/docs/guides)
- [حزم SDK](https://runapi.ai/ar/sdk.md)
- [CLI](https://runapi.ai/ar/cli.md)
- [خادم MCP](https://runapi.ai/ar/mcp.md)
- [x402](https://runapi.ai/ar/x402.md)
### الأدلة
- [Claude Code مقابل Cursor](https://runapi.ai/ar/claude-code-vs-cursor.md)
- [إعداد Cursor API](https://runapi.ai/ar/cursor-api-setup.md)
- [RunAPI مقابل OpenRouter](https://runapi.ai/ar/openrouter-alternative.md)
### الشركة
- [المؤسسات](https://runapi.ai/ar/contact.md)
- [اتصل بنا](https://runapi.ai/ar/contact.md)
### القانوني
- [الشروط](https://runapi.ai/ar/terms.md)
- [الخصوصية](https://runapi.ai/ar/privacy.md)
- [Site index for agents](https://runapi.ai/llms.txt)

Contact: contact@runapi.ai

## Structured data

```json
[
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "WebSite",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "potentialAction": {
      "@type": "SearchAction",
      "target": {
        "@type": "EntryPoint",
        "urlTemplate": "https://runapi.ai/ar/models?q={search_term_string}"
      },
      "query-input": "required name=search_term_string"
    }
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "Organization",
    "name": "RunAPI",
    "url": "https://runapi.ai/ar",
    "logo": {
      "@type": "ImageObject",
      "url": "https://runapi.ai/aricon.svg"
    },
    "sameAs": [
      "https://github.com/runapi-ai"
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "SoftwareApplication",
    "name": "RunAPI Suno لـ WorkBuddy",
    "applicationCategory": "DeveloperApplication",
    "description": "ولّد أغاني باستخدام Suno من الإصدار v4 إلى v5.5 في WorkBuddy عبر خادم MCP الخاص بـ RunAPI. مفتاح واحد، وأوضاع صوتية، واستطلاع غير متزامن يتولاه وكيل المنضدة.",
    "url": "https://runapi.ai/ar/workbuddy-suno"
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "FAQPage",
    "mainEntity": [
      {
        "@type": "Question",
        "name": "كيف أكتب وصفاً أفضل لـSuno للحصول على النوع والأسلوب الموسيقي المطلوب؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "كن محدداً بشأن النوع الموسيقي والمزاج والإيقاع والآلات في موجزك لـ WorkBuddy. على سبيل المثال، \"إيندي بوب نشيط بـ 120 BPM مع جيتار صوتي وسينث دافئ\" أفضل من \"أغنية سعيدة\". اطلب من الوكيل تمرير negative_tags لاستبعاد عناصر غير مرغوبة كالميتال الثقيل أو الصراخ."
        }
      },
      {
        "@type": "Question",
        "name": "أي إصدار Suno يجب أن أستخدم — v4 أو v5 أو v5.5؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "suno-v5.5 هو الأحدث ويُنتج أعلى جودة مع وضوح صوتي وميكساج أفضل. suno-v4 وsuno-v4.5 أرخص وأسرع للنسخ التجريبية. جميع الإصدارات خلف نفس خادم MCP باسم runapi، لذا يكفي تسمية إصدار مختلف في نصك."
        }
      },
      {
        "@type": "Question",
        "name": "هل يجب أن أستطلع المهمة بنفسي في WorkBuddy؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "لا. مهام Suno غير متزامنة، لكن وكيل المنضدة يتولى دورة حياتها — يُنشئ المهمة عبر أداة MCP، ويستطلع حتى تكتمل، ويُرسل رابط الصوت إلى المحادثة. ما عليك سوى وصف الأغنية والانتظار."
        }
      },
      {
        "@type": "Question",
        "name": "هل توفّر RunAPI API رسمياً لـSuno؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "لا تقدّم Suno API عاماً. توفّر RunAPI وصولاً برمجياً إلى Suno من v4 حتى v5.5 عبر نفس مفتاح الـAPI ودورة حياة المهام المستخدمة لجميع نماذج RunAPI. لا حاجة لحساب Suno أو بيانات اعتماد منفصلة."
        }
      },
      {
        "@type": "Question",
        "name": "هل يمكنني التحكم في جنس الصوت ووزن الأسلوب؟",
        "acceptedAnswer": {
          "@type": "Answer",
          "text": "نعم. اطلب vocal_gender ذكر أو أنثى، واستخدم negative_tags لاستبعاد الأساليب غير المرغوبة. للتحكم الدقيق، أنشئ شخصية عبر endpoint باسم personas ومرّر persona_id المُعاد مع ضبط persona_type على voice أو style."
        }
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "HowTo",
    "name": "كيفية استخدام Suno في WorkBuddy عبر RunAPI",
    "description": "أضف RunAPI كخادم MCP في WorkBuddy، صِف الأغنية لوكيل المنضدة، ودعه يُشغّل مهمة Suno غير المتزامنة ويُعيد رابط الصوت النهائي.",
    "step": [
      {
        "@type": "HowToStep",
        "position": 1,
        "name": "أضف RunAPI كخادم MCP",
        "text": "عيّن RUNAPI_API_KEY في البيئة التي تُشغّل WorkBuddy، ثم سجّل خادم MCP باسم runapi يشير إلى https://runapi.ai/mcp عبر HTTP القابل للبث. تظهر Suno كأداة موسيقية قابلة للاستدعاء جنباً إلى جنب مع كل نماذج RunAPI الأخرى — دون الحاجة إلى ربط خدمة موسيقى منفصلة.",
        "url": "https://runapi.ai/ar/workbuddy-suno#how-step-1"
      },
      {
        "@type": "HowToStep",
        "position": 2,
        "name": "صِف الأغنية للوكيل",
        "text": "أخبر WorkBuddy بما تريد بلغة طبيعية وحدد الوضع. استخدم auto_lyrics مع نص للكلمات المكتوبة بالذكاء الاصطناعي، أو exact_lyrics مع كلمات/أسلوب/عنوان لكلماتك الخاصة، أو instrumental مع أسلوب/عنوان بدون أصوات بشرية. يُحوّل الوكيل موجزك إلى استدعاء أداة Suno.",
        "url": "https://runapi.ai/ar/workbuddy-suno#how-step-2"
      },
      {
        "@type": "HowToStep",
        "position": 3,
        "name": "دع الوكيل يستطلع ويجمع الصوت",
        "text": "توليد الأغاني غير متزامن ويستغرق من 30 ثانية إلى عدة دقائق حسب الإصدار. يستطلع وكيل المنضدة المهمة حتى تكتمل، ثم يُرسل رابط الصوت الناتج إلى المحادثة — دون أن تتعامل مع task_id بنفسك.",
        "url": "https://runapi.ai/ar/workbuddy-suno#how-step-3"
      }
    ]
  },
  {
    "@context": "https://schema.org",
    "inLanguage": "ar",
    "@type": "BreadcrumbList",
    "itemListElement": [
      {
        "@type": "ListItem",
        "position": 1,
        "name": "الرئيسية",
        "item": "https://runapi.ai/ar"
      },
      {
        "@type": "ListItem",
        "position": 2,
        "name": "RunAPI Suno لـ WorkBuddy",
        "item": "https://runapi.ai/ar/workbuddy-suno"
      }
    ]
  }
]
```
