> ## Documentation Index
> Fetch the complete documentation index at: https://germeytechnology-docs-remove-4o-image-nav.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# تعليمات دمج واجهة برمجة تطبيقات استنساخ الصوت Suno

> Suno Music Generation 集成指南 - Ace Data Cloud

تسمح لنا SUNO بإنشاء شخصيات صوتية مخصصة من خلال أي ملف صوتي، لتحقيق استنساخ الصوت لاستخدامه في توليد الموسيقى. بخلاف واجهة برمجة التطبيقات Persona API الموجودة (التي تستخدم `audio_id` الذي تم إنشاؤه بواسطة Suno)، تقبل هذه الواجهة رابط `audio_url` متاحًا للعامة، وهو تسجيل صوتي بشري خاص بك. تشرح هذه الوثيقة كيفية دمج واجهة برمجة تطبيقات استنساخ الصوت.

## الخطوة الأولى: إنشاء شخصية صوتية

تحتوي هذه الواجهة على ثلاثة معلمات إدخال: `audio_url` (إلزامي)، وهو رابط ملف صوتي بصيغة MP3 أو WAV متاح للعامة ويحتوي على صوت بشري واضح لشخص واحد؛ و`name` و`description` (اختياريان)، وهما اسم ووصف الشخصية الصوتية.

**متطلبات ملف الصوت:**

* الصيغة: MP3 أو WAV
* الطول: لا يقل عن 10 ثوانٍ
* المحتوى: صوت بشري واضح لشخص واحد، مع تقليل الضوضاء الخلفية أو الموسيقى قدر الإمكان

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/voices' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "audio_url": "http://cos.aitutu.cc/mp4/ru-user-voice.mp3",
  "name": "RU User Voice Test",
  "description": "用户语音录音示例"
}'
```

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

```json theme={null}
{
  "success": true,
  "task_id": "b9150e51-d87c-4556-a55e-100947a63bdf",
  "data": {
    "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b",
    "name": "RU User Voice Test",
    "is_public": false
  }
}
```

يمكن ملاحظة أن حقل `persona_id` في `data` هو معرف الشخصية الصوتية التي تم إنشاؤها. حقل `is_public` يكون دائمًا `false` لأن الشخصيات الصوتية التي تم إنشاؤها عبر رفع الصوت هي خاصة.

## الخطوة الثانية: استخدام الشخصية الصوتية لتوليد الموسيقى

بعد الحصول على معرف الشخصية الصوتية، يمكننا استخدام [واجهة برمجة تطبيقات توليد الصوتيات Suno](https://platform.acedata.cloud/documents/suno-audios) لتوليد الموسيقى. قم بتعيين `action` إلى `generate`، و`persona_id` إلى معرف الشخصية الصوتية الذي تم إرجاعه أعلاه، وسيتم أداء الأغنية باستخدام الصوت المستنسخ.

> **ملاحظة:** استنساخ الصوت مدعوم فقط للنماذج `chirp-v4-5` وما فوق (مثل `chirp-v4-5`، `chirp-v5`، `chirp-v5-5`)، ولا يدعم `chirp-v4`.

```bash theme={null}
curl -X POST 'https://api.acedata.cloud/suno/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "chirp-v5-5",
  "prompt": "A warm synth-pop song about city nights",
  "persona_id": "e95013f8-eaee-4741-a42f-1d559a9d0b2b"
}'
```

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

```json theme={null}
{
  "success": true,
  "task_id": "53d8a334-a972-43c5-895e-60c4454e88d5",
  "data": [
    {
      "id": "16463960-077c-4700-bbb3-3c7897b943d3",
      "title": "Soft Neon on My Skin",
      "audio_url": "https://cdn1.suno.ai/16463960-077c-4700-bbb3-3c7897b943d3.mp3",
      "image_url": "https://cdn2.suno.ai/image_16463960-077c-4700-bbb3-3c7897b943d3.jpeg",
      "model": "chirp-v5-5",
      "state": "succeeded",
      "prompt": "A warm synth-pop song about city nights",
      "duration": 156.28
    }
  ]
}
```

يمكن ملاحظة أن الأغنية المولدة تم أداؤها باستخدام الصوت المستنسخ. يمكن أيضًا استخدام `persona_id` مع إجراء `cover` لإعادة أداء أغاني موجودة باستخدام الصوت المستنسخ.