> ## 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 Music Generation 集成指南 - XHuoAPI

تسمح لنا SUNO بتحديد أسلوب المغني للأغاني التي تم إنشاؤها بالفعل، ثم إعادة الإبداع بناءً على ذلك. تشرح هذه الوثيقة كيفية توصيل واجهة برمجة التطبيقات ذات الصلة.

تحتوي هذه الواجهة على ثلاثة معلمات إدخال فقط، أولاً `audio_id`، وهو معرف الأغنية التي تم إنشاؤها بنجاح من قبل، وثانياً `name` و `description`، وهما اسم ووصف لنوع أسلوب المغني.

هنا، نستخدم `audio_id` وهو `https://cdn.xhuoapi.ai/2qhzs3.png`، يمكن الرجوع إلى [واجهة برمجة تطبيقات توليد الصوت من سنو](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) لتوليد أغاني مخصصة، وفي النهاية يمكن الحصول على `audio_id`.

```bash theme={null}
curl -X POST 'https://api.xhuoapi.ai/v1/suno/persona' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "test",
  "audio_id": "81745564-60e7-4ad4-85a9-6f42f0f4f3b3",
  "description": "test"
}'
```

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

```
{
  "success": true,
  "task_id": "8e808558-f056-456f-91d6-b97fd94eb3be",
  "data": {
    "persona_id": "dae4ae5d-2b51-4af1-b286-1a4473ef4dba"
  }
}
```

يمكننا أن نرى أن حقل `persona_id` في `data` هو معرف أسلوب المغني الذي تم إنشاؤه.

بعد الحصول على معرف أسلوب المغني، يمكننا استخدام [واجهة برمجة تطبيقات توليد الصوت من سنو](https://api.xhuoapi.ai/documents/4da95d9d-7722-4a72-857d-bf6be86036e9) لتوليد أغاني مخصصة، على سبيل المثال، يتم تمرير `action` كـ `artist_consistency`، بينما يتم تمرير `audio_id` كمعرف الأغنية المرفوعة، كما نحتاج إلى رفع المعلمة `persona_id`، وهذه القيمة هي معرف أسلوب المغني الذي تم إرجاعه أعلاه، وبالتالي يمكننا توليد أغاني جديدة بناءً على أسلوب المغني المرجعي.