الانتقال إلى المحتوى الرئيسي

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 ذات الصلة. المُدخل الأساسي لهذا API هو audio_id، وهو معرف الأغنية الذي تم إنشاؤه رسميًا؛ كما يدعم اختياريًا عنوان callback_url للرد غير المتزامن. هنا المُدخل audio_id هو 4e43116a-bf09-472c-8e1c-655eabf02682. 
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)
النتيجة كما يلي: 
{
  "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 يومًا يتم تنظيف الملف دوريًا، لذا يُنصح بتنزيله وحفظه بشكل آمن في التخزين الخاص بك في أقرب وقت ممكن. في حالة فشل النسخ (وهو أمر نادر جدًا)، سيتم الرجوع إلى رابط المصدر الأصلي، مما يحافظ على السلوك كما في السابق.