---
title: واجهة برمجة الموسيقى من RunAPI - واجهة برمجة توليد الموسيقى بالذكاء الاصطناعي | RunAPI
description: أنشئ مقطوعات كاملة، وموسيقى آلية، وطبقات صوتية منفصلة عبر واجهة برمجة واحدة لتوليد الموسيقى بالذكاء الاصطناعي.
url: https://runapi.ai/ar/music.md
canonical: https://runapi.ai/ar/music
locale: ar
site: RunAPI
image: https://runapi.ai/assets/opengraph-f702f2b1.png
alternates:
  en: https://runapi.ai/music
  zh-CN: https://runapi.ai/zh-CN/music
  es: https://runapi.ai/es/music
  ja: https://runapi.ai/ja/music
  de: https://runapi.ai/de/music
  fr: https://runapi.ai/fr/music
  pt-BR: https://runapi.ai/pt-BR/music
  ko: https://runapi.ai/ko/music
  it: https://runapi.ai/it/music
  nl: https://runapi.ai/nl/music
  pl: https://runapi.ai/pl/music
  tr: https://runapi.ai/tr/music
  zh-TW: https://runapi.ai/zh-TW/music
  zh-HK: https://runapi.ai/zh-HK/music
  ar: https://runapi.ai/ar/music
  x-default: https://runapi.ai/music
---

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


# واجهة برمجة توليد الموسيقى بالذكاء الاصطناعي

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

- [احصل على مفتاح API](https://runapi.ai/ar/login)
- [تصفح النماذج](https://runapi.ai/ar/models.md)

14 نموذج موسيقي · مقطوعات كاملة بأداء صوتي · الدفع لكل ثانية

## بيئة التجربة

Available models: Producer/fuzz-0.8 ($0.13 / track), Suno/suno-v4 ($0.17 / track)

## استمع إلى مقطوعات مُولّدة بالذكاء الاصطناعي

- **أوركسترالي سينمائي — ملحمي** - أوركسترالي, إعلان ترويجي, بطولي - 3:24 - Suno v4
- **حلقة لو-فاي للدراسة** - لو-فاي, هادئ, آلي - 2:48 - Suno v4
- **قيادة ليلية بأسلوب Synthwave** - سينثويف, ريترو, قيادة - 4:02 - Udio 2
- **شروق شمس فولك أكوستيك** - فولك, أكوستيك, دافئ - 3:10 - Udio 2

## كل ما يمكن أن تفعله نقطة نهاية الموسيقى

- **تحويل النص إلى موسيقى** - صِف النمط والمزاج والإيقاع واحصل على مقطوعة مكتملة — بغناء أو من دونه.
- **تمديد الموسيقى** - أكمل مقطوعة موجودة إلى مدة مستهدفة مع الحفاظ على المقام والإيقاع والتوزيع.
- **فصل الطبقات الصوتية** - قسّم التسجيل إلى غناء وطبلة وباص وعناصر أخرى للمزج أو إعادة التوزيع.
- **توليد كلمات الأغنية** - صِغ كلمات مُهيكلة بعلامات المقطع واللازمة، ثم غذِّها مباشرةً إلى توليد صوتي.

## نماذج موسيقية بمفتاح واحد

| Model | Provider | Price |
| --- | --- | --- |
| Producer/fuzz-0.8 | Producer | $0.13 / track |
| Suno/suno-v4 | Suno | $0.17 / track |


[عرض جميع النماذج الموسيقية البالغ عددها 14](https://runapi.ai/ar/models.md)


## البدء السريع

### أنشئ مقطوعة

#### curl

```bash
curl https://runapi.ai/api/v1/producer/text_to_music \
  -H "Authorization: Bearer $RUNAPI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model":"fuzz-0.8","vocal_mode":"instrumental","prompt":"Soft piano with gentle percussion."}'
```

#### Python

```python
import json
import os
import requests

response = requests.post(
    "https://runapi.ai/api/v1/producer/text_to_music",
    headers={"Authorization": f"Bearer {os.environ['RUNAPI_API_KEY']}"},
    json=json.loads("{\"model\":\"fuzz-0.8\",\"vocal_mode\":\"instrumental\",\"prompt\":\"Soft piano with gentle percussion.\"}")
)
response.raise_for_status()
print(response.json())
```

#### Node.js

```javascript
const response = await fetch("https://runapi.ai/api/v1/producer/text_to_music", {
  method: "POST",
  headers: {
    "Authorization": "Bearer " + process.env.RUNAPI_API_KEY,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({"model":"fuzz-0.8","vocal_mode":"instrumental","prompt":"Soft piano with gentle percussion."})
});
console.log(await response.json());
```

#### Go

```go
package main

import (
    "io"
    "net/http"
    "os"
    "strings"
)

func main() {
    payload := strings.NewReader("{\"model\":\"fuzz-0.8\",\"vocal_mode\":\"instrumental\",\"prompt\":\"Soft piano with gentle percussion.\"}")
    request, err := http.NewRequest("POST", "https://runapi.ai/api/v1/producer/text_to_music", payload)
    if err != nil { panic(err) }
    request.Header.Set("Authorization", "Bearer "+os.Getenv("RUNAPI_API_KEY"))
    request.Header.Set("Content-Type", "application/json")
    response, err := http.DefaultClient.Do(request)
    if err != nil { panic(err) }
    defer response.Body.Close()
    io.Copy(os.Stdout, response.Body)
}
```

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

```json
{
  "id": "tsk_example",
  "status": "processing"
}
```


## أربع خطوات لأول عملية توليد لك

**كيف يعمل**

1. **احصل على مفتاح API الخاص بك** - مفتاح واحد لجميع نماذج توليد الموسيقى.
2. **صِف مقطوعتك** - اكتب وصفًا نصيًا يتضمن النمط والمزاج والإيقاع وتفاصيل الآلات.
3. **توليد** - أرسل طلب POST إلى /api/v1/producer/text_to_music. اختر من بين النماذج الموسيقية المتاحة.
4. **بث أو تنزيل** - احصل على مقطوعتك المُولّدة بصيغة MP3/WAV. فصل الطبقات الصوتية متاح.


## لماذا يختار المطورون RunAPI

- **مفتاح واحد، جميع النماذج** - توقف عن إدارة مفاتيح API متعددة. يمنحك تكامل واحد الوصول إلى 230+ نموذجًا لدى جميع المزوّدين.
- **توفير في التكلفة بنسبة 15-25%** - تمنحنا اتفاقيات الحجم مع المزوّدين أسعارًا أقل من الشراء المباشر، من دون هامش إضافي.
- **تحويل تلقائي عند التعطل** - إذا توقف أحد المزوّدين، نوجّه الطلب إلى الخيار الأفضل التالي ليظل تطبيقك يعمل.
- **متوافق مع OpenAI** - بديل مباشر لـ OpenAI SDK. غيّر سطرًا واحدًا للوصول إلى أي نموذج.
- **فوترة فورية** - ادفع مقابل ما تستخدمه فقط، بتسعير لكل طلب ومن دون حد أدنى، مع تتبع التكلفة لكل نموذج ومشروع.
- **خصوصية البيانات** - توضح سياسة الخصوصية لدينا كيفية معالجة بيانات الطلبات والمحتوى المُنشأ والاحتفاظ بها.


### استكشف

## المزيد من واجهات برمجة الذكاء الاصطناعي

- [واجهة الفيديو](https://runapi.ai/ar/models?modality=video) - أنشئ وعدّل وحسّن جودة الفيديو مع 80 نموذج [اعرف المزيد](https://runapi.ai/ar/models?modality=video)
- [واجهة الصور](https://runapi.ai/ar/models?modality=image) - أنشئ وحوّل الصور مع 49 نموذج [اعرف المزيد](https://runapi.ai/ar/models?modality=image)
- [واجهة الصوت](https://runapi.ai/ar/models?modality=audio_music) - أنشئ الكلام والصوت مع 31 نموذج [اعرف المزيد](https://runapi.ai/ar/models?modality=audio_music)
- [واجهة النماذج اللغوية](https://runapi.ai/ar/models?modality=text) - إتمامات محادثة مع 66 نموذج لغوي [اعرف المزيد](https://runapi.ai/ar/models?modality=text)



## ما تبنيه الفرق باستخدامه

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


## RunAPI مقابل البدائل

| الميزة | RunAPI | Suno مباشرة | Replicate |
| --- | --- | --- | --- |
| النماذج الموسيقية | 14 | غير متاح | غير متاح |
| التسعير | $0.13 / track | غير متاح | غير متاح |
| فصل الطبقات الصوتية | نعم | غير متاح | غير متاح |
| فوترة موحدة | نعم | غير متاح | غير متاح |
| خادم MCP | نعم | غير متاح | غير متاح |
| تحويل تلقائي بين المزوّدين | نعم | غير متاح | غير متاح |

## أسئلة حول واجهة برمجة الموسيقى

### كيف يتم احتساب فوترة الموسيقى؟

حسب ثانية الصوت المُولّد. تصل تكلفة مقطوعة مدتها 30 ثانية على Suno إلى نحو دولار واحد، ولا تُفرض رسوم على عمليات التوليد الفاشلة.
### هل يمكنني الحصول على غناء؟

نعم. اترك instrumental بقيمة false ومرّر lyrics، أو دع النموذج يكتبها لك أولًا عبر نقطة نهاية كلمات الأغاني.
### هل يمكنني الحصول على طبقات صوتية منفصلة؟

نعم. استخدم task_type بقيمة separate_stems على تسجيل مكتمل للحصول على الغناء والطبلة والباص وعناصر أخرى كملفات مستقلة.
### ما أقصى مدة يمكن أن تصل إليها المقطوعة؟

حتى 4 دقائق في طلب واحد على Suno وUdio. تُبنى المقطوعات الأطول بتمديد تسجيل موجود.
### هل يمكنني استخدام المخرجات تجاريًا؟

يعتمد ذلك على ترخيص مزوّد النموذج، الذي يربطه الفهرس بكل نموذج. لا تضيف RunAPI أي قيود إضافية.
### كم يستغرق التوليد؟

تقريبًا من 40 إلى 90 ثانية لمقطوعة مدتها 30 ثانية. استخدم webhook بدلًا من الاستعلام المتكرر عن حالة المهمة.

## صمّم موسيقى منتجك بموسيقى مُولّدة

Suno وUdio خلف مفتاح واحد، بفوترة لكل ثانية. ابدأ مجانًا، من دون الحاجة إلى بطاقة ائتمان.

- [احصل على مفتاح API](https://runapi.ai/ar/login)
- [اطّلع على التوثيق](https://runapi.ai/ar/docs/guides)


---

## 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)
### الأدلة
- [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"
    ]
  }
]
```