Перейти до основного вмісту

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 дозволяє створювати кастомізовані голосові персонажі на основі будь-яких аудіофайлів, реалізуючи клонування голосу для генерації музики. На відміну від існуючого Persona API (який використовує audio_id, згенерований Suno), цей API приймає публічно доступний audio_url — тобто ваш власний запис голосу. У цьому документі описано, як інтегрувати API клонування голосу.

​
Крок 1: Створення голосового персонажа

API має три вхідні параметри: audio_url (обов’язковий) — URL публічно доступного аудіофайлу у форматі MP3 або WAV, що містить чіткий голос однієї людини; name та description (опціонально) — назва та опис голосового персонажа. Вимоги до аудіофайлу:
  • Формат: MP3 або WAV
  • Тривалість: не менше 10 секунд
  • Зміст: чіткий голос однієї людини, мінімум фонових шумів або музики
curl -X POST 'https://api.xhuoapi.ai/v1/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": "用户语音录音示例"
}'
Результат: 
{
  "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 — це ID створеного голосового персонажа. Поле is_public завжди має значення false, оскільки голосові персонажі, створені завантаженням аудіо, є приватними.

​
Крок 2: Використання голосового персонажа для генерації музики

Після отримання ID голосового персонажа можна використовувати Suno Audios Generation API для генерації музики. Встановіть action у generate, а persona_id — у ID створеного голосового персонажа. Згенерована пісня буде виконана клонованим голосом.
Увага: Клонування голосу підтримується лише моделями chirp-v4-5 і вище (наприклад, chirp-v4-5, chirp-v5, chirp-v5-5), не підтримується chirp-v4. 
curl -X POST 'https://api.xhuoapi.ai/v1/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"
}'
Результат: 
{
  "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 для виконання каверів існуючих пісень клонованим голосом.