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

# تعليمات دمج Suno Wav API

> Suno Music Generation 集成指南 - XHuoAPI

تسمح لنا SUNO بالحصول على ملفات الموسيقى بصيغة wav، تشرح هذه الوثيقة طريقة دمج API ذات الصلة.

المُدخل الأساسي لهذا API هو `audio_id`، وهو معرف الأغنية الذي تم إنشاؤه رسميًا؛ كما يدعم اختياريًا عنوان `callback_url` للرد غير المتزامن.

هنا المُدخل `audio_id` هو `4e43116a-bf09-472c-8e1c-655eabf02682`.

```python theme={null}
import requests

url = "https://api.xhuoapi.ai/v1/suno/wav"

headers = {
    "accept": "application/json",
    "authorization": "Bearer aa287fa4cc54401087a9fab3f99630af",
    "content-type": "application/json"
}

payload = {
    "audio_id": "4e43116a-bf09-472c-8e1c-655eabf02682"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)
```

النتيجة كما يلي:

```json theme={null}
{
  "success": true,
  "task_id": "6a5a2099-d6d3-4930-9709-a30ac5dc7de5",
  "trace_id": "3fa70e81-6bb7-4ca8-b718-dd16a4eda7e8",
  "data": [
    {
      "file_url": "https://platform.cdn.xhuoapi.ai/suno/6a5a2099-d6d3-4930-9709-a30ac5dc7de5.wav"
    }
  ]
}
```

يمكننا أن نرى أن حقل `file_url` ضمن `data` هو ملف الموسيقى بصيغة wav الذي تم الحصول عليه، وهو عنوان CDN يمكن الوصول إليه علنًا.

> **حول استمرارية وصلاحية رابط WAV**
>
> ملفات WAV على CDN الخاص بـ Suno في المصدر (`https://cdn1.suno.ai/{audio_id}.wav`) تُحتفظ بها لبضعة أيام فقط، وبعدها يتم استرجاعها، وعند الوصول إليها يتم إرجاع خطأ 403.
> لتجنب انتهاء صلاحية الرابط، يقوم هذا الواجهة تلقائيًا قبل الإرجاع بنسخ ملف WAV من المصدر إلى CDN الخاص بنا (`https://platform.cdn.xhuoapi.ai/suno/{task_id}.wav`)، والرابط `file_url` المُعاد هو العنوان المستقر بعد النسخ، ولن ينتهي صلاحية الرابط فور انتهاء صلاحية CDN المصدر.
> **مدة صلاحية الرابط بعد النسخ هي 30 يومًا**، وبعد مرور 30 يومًا يتم تنظيف الملف دوريًا، لذا يُنصح بتنزيله وحفظه بشكل آمن في التخزين الخاص بك في أقرب وقت ممكن.
> في حالة فشل النسخ (وهو أمر نادر جدًا)، سيتم الرجوع إلى رابط المصدر الأصلي، مما يحافظ على السلوك كما في السابق.