---
title: "استخدام Suno في OpenClaw عبر RunAPI — دليل واجهة برمجة الموسيقى"
url: "https://runapi.ai/ar/openclaw-suno.md"
canonical: "https://runapi.ai/ar/openclaw-suno"
locale: "ar"
model: "suno"
---

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

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

## API example

```bash
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"
  }'

```

### Response

```json
{
  "task_id": "tsk_abc123",
  "status": "pending",
  "model": "suno-v5.5"
}

```

## How it works

1. **تهيئة RunAPI** — عيّن RUNAPI_API_KEY في بيئتك. إن كنت قد هيّأت RunAPI في OpenClaw للدردشة مسبقاً، فالمفتاح ذاته يعمل مع توليد الموسيقى بـ Suno دون الحاجة لإعداد مزوّد إضافي.
2. **استدعاء text_to_music** — أرسل طلب POST إلى نقطة نهاية text_to_music مع تحديد النموذج والوضع الصوتي. استخدم auto_lyrics مع نص وصفي لكتابة كلمات الأغنية بالذكاء الاصطناعي، أو exact_lyrics مع الكلمات والأسلوب والعنوان لكلماتك الخاصة، أو instrumental مع الأسلوب والعنوان لمقطوعة بلا أصوات بشرية.
3. **استطلاع النتيجة** — تُعيد نقطة النهاية task_id فوراً. يستغرق توليد الأغنية من 30 ثانية إلى عدة دقائق حسب الإصدار. استطلع نقطة نهاية حالة المهمة حتى تصبح الحالة "completed"، ثم اقرأ رابط الصوت من الاستجابة.

## Parameters

| Parameter | Type | Description |
|-----------|------|-------------|
| `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 عند اكتمال المهمة. |

## FAQ

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

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

### أيّ إصدار Suno يجب استخدامه؟

suno-v5.5 هو الأحدث ويُنتج أعلى جودة مع وضوح صوتي ومزج أفضل. suno-v4 وsuno-v4.5 أرخص وأسرع للمسودات الأولية. جميع الإصدارات تستخدم نفس نقطة نهاية text_to_music والمعاملات ذاتها.

### كم يستغرق توليد Suno؟

يتفاوت وقت التوليد حسب الإصدار وطول الأغنية. المدة المعتادة من 30 ثانية إلى دقيقتين. تُعيد الواجهة البرمجية task_id فوراً — استطلع نقطة نهاية الحالة أو عيّن callback_url لتجنب تعليق عميلك.

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

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

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

نعم. عيّن vocal_gender إلى male أو female. استخدم negative_tags لاستبعاد الأساليب غير المرغوبة. لمزيد من الدقة، أنشئ شخصية عبر نقطة نهاية generate_persona ومرّر persona_id المُعاد مع persona_type محدداً بـ voice أو style.


## Links

- [دليل إعداد OpenClaw →](https://runapi.ai/ar/openclaw)
- [نماذج Suno →](https://runapi.ai/ar/models/suno)
- [Model catalog](https://runapi.ai/ar/models)
- [API docs](https://runapi.ai/ar/docs)