> ## Documentation Index
> Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt
> Use this file to discover all available pages before exploring further.

# تعليمات دمج واجهة برمجة تطبيقات Suno MP3 URL

> Suno Music Generation API guide - Ace Data Cloud

واجهة برمجة تطبيقات Suno MP3 URL تولد مسارًا لعنوان قابل للتشغيل ينتهي بـ `.mp3` لموسيقى موجودة، وهي مناسبة لحالات تعطل روابط التنزيل القديمة، أو التشغيل على الأجهزة المحمولة، أو الحاجة إلى إعادة الحصول على عنوان الصوت العام.

المعلمة المطلوبة `audio_id` هي معرف الصوت الذي ترجع به واجهة توليد الصوت من Suno. كل استدعاء ينشئ مهمة URL MP3 مستقلة، ولن يعدل مهمة توليد الموسيقى الأصلية، ولن يغير معرف الصوت الأصلي.

## الاستدعاء المتزامن

```python theme={null}
import requests

response = requests.post(
    "https://api.acedata.cloud/suno/mp3",
    headers={
        "accept": "application/json",
        "authorization": "Bearer <YOUR_API_TOKEN>",
        "content-type": "application/json"
    },
    json={"audio_id": "ef1ec21e-1540-4eb6-8fa5-26cb8b90d28f"},
    timeout=240
)
response.raise_for_status()
result = response.json()
print(result["data"][0]["file_url"])
```

عند النجاح، `data[0].file_url` هو عنوان الصوت القابل للتشغيل. ستقوم الواجهة بتخزينه أولاً في `https://cdn.acedata.cloud/suno/{audio_id}.mp3`؛ إذا فشلت عملية التخزين، فستعيد العنوان الأصلي المتاح.

## الاستدعاء غير المتزامن

عند الحاجة إلى وقت معالجة أطول، يمكن تمرير `async: true`:

```python theme={null}
submission = requests.post(
    "https://api.acedata.cloud/suno/mp3",
    headers={"authorization": "Bearer <YOUR_API_TOKEN>"},
    json={
        "audio_id": "ef1ec21e-1540-4eb6-8fa5-26cb8b90d28f",
        "async": True
    }
).json()

export_task_id = submission["task_id"]
```

بعد ذلك، يمكن الاستعلام عن `export_task_id` من خلال `/suno/tasks`. يمكن أيضًا تقديم `callback_url` لاستقبال النتيجة النهائية بعد إكمال المهمة. تستخدم الاستجابة المتزامنة، واستعلام المهمة، والاستدعاء نفس بنية البيانات النهائية.

## ملاحظات

* يجب أن يأتي `audio_id` من صوت Suno يمكن التعرف عليه.
* مهام URL MP3 مستقلة عن مهام توليد الموسيقى الأصلية.
* الفشل في التخزين لن يمنع النتائج، وسيعود إلى العنوان الأصلي؛ يرجى التنزيل في الوقت المناسب.
* يُنصح بأن يقوم الجانب التجاري بتنزيل النتائج في الوقت المناسب وحفظها وفقًا لاستراتيجية الاحتفاظ بالبيانات الخاصة بهم.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.