API ремастерингу (Remaster)

Оновлено 2026-09-18 · команда Suno-API

Опис кінцевої точки

Ремастеринг створює з завершеної пісні «ремастеризовану версію» з кращою якістю звуку. За один виклик повертаються 2 версії, а апстрим автоматично додає до назви (Remastered).

Кінцева точка: POST /api/music/remaster

Оплата: платно, тарифікується за запитаною моделлю (типово suno-v6, 0,6 юаня за виклик); фактично списана сума відповідає конфігурації цін у бек-офісі.

Про модель: ремастеринг використовує окрему кінцеву точку апстриму й окрему модель ремастерингу, які задає платформа, і вони не змінюються від model; model у запиті впливає лише на ціну та вибір каналу, тому рекомендується явно передавати suno-v6.

Час очікування та тайм-аути (важливо): це синхронна кінцева точка — замовлення приймають і передають на ремастеринг лише коли надходить відповідь. Установіть тайм-аут клієнта 300 секунд або більше; відсутність відповіді не означає, що ремастеринг не зроблено, і не повторюйте запит одразу після тайм-ауту (це дублює замовлення й списує кошти вдруге). Якщо з'єднання обірвалося, перевірте пізніше через GET /api/music/songs.

Автентифікація

Параметри запиту

audio_id, source_clip_id і sourceClipId — рівнозначні написання song_id; використовуйте будь-яке з них.

Приклад запиту

curl -X POST https://www.suno-api.io/api/music/remaster \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "song_id": "source_song_id",
    "variation_category": "high",
    "style_profile": "clarity"
  }'

Якщо типових значень достатньо, передайте лише вихідну пісню — це еквівалентно variation_category: normal + style_profile: boost:

{ "model": "suno-v6", "song_id": "source_song_id" }

Відповідь

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Назва вихідної пісні (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Назва вихідної пісні (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Один виклик повертає 2 ремастеризовані версії. Збережіть обидва clips[].song_id і опитуйте API запиту пісень та історії до стану complete, перш ніж забирати аудіо.

Примітки

• Вихідна пісня має бути завершена й перебувати в зоні доступу поточного ключа API; зовнішній вихідний матеріал автоматично синхронізується з акаунтом-виконавцем.
• Ремастеринг лише переробляє якість звуку: щоб змінити стиль, аранжування чи вокал, скористайтеся підсиленням стилю, завантаженням із наступним кавером або кінцевими точками Remix.
• Чим більше variation_category, тим сильніше ремастеризована версія відрізняється від вихідної пісні; перед реальною здачею спробуйте normal, а потім підвищуйте.