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

# استخدم Suno في Hermes Agent.

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

## 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 في البيئة التي يعمل فيها Hermes Agent. إن كنت قد أضفت RunAPI مسبقاً كمزوّد custom:runapi، فالمفتاح وbase_url ذاتهما يعالجان طلبات موسيقى 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 يُنتج مقطوعة بلا أصوات بشرية باستخدام الأسلوب والعنوان فقط.

### كيف أهيّئ RunAPI كمزوّد مخصص في Hermes Agent لاستخدام Suno؟

أضف مزوّد custom:runapi في إعدادات Hermes Agent مع تعيين base_url إلى https://runapi.ai/v1 وapi_key يقرأ من RUNAPI_API_KEY. يعالج المزوّد ذاته طلبات الدردشة والصور والفيديو والموسيقى — لا حاجة لإعداد منفصل لـ Suno.

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

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

### هل يمكنني توليد مقطوعات آلية بلا أصوات بشرية؟

نعم. عيّن vocal_mode إلى instrumental وقدّم حقلَي style وtitle. يجب حذف حقلَي prompt وlyrics في وضع instrumental. تُطبّق الواجهة البرمجية هذه القواعد عبر الحقول وترجع خطأ تحقق عند إرسال حقول متعارضة.

### ما نقاط نهاية Suno الأخرى المتاحة بجانب text_to_music؟

تُتيح RunAPI cover_audio (لإعادة أسلوب مسار موجود)، وextend_music (لمتابعة أغنية من لحظة زمنية محددة)، وcreate_mashup (لدمج عناصر من مسارات متعددة)، وtext_to_sound (للمؤثرات الصوتية)، ونقاط نهاية مساعدة مثل generate_lyrics وgenerate_persona وseparate_audio_stems. جميعها تشترك في مفتاح API ودورة حياة المهام ذاتها.


## Links

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