API генерації/отримання WAV

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

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

Кінцева точка WAV створює або отримує адресу WAV-аудіо без втрат для наявної пісні.

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

Оплата: Безкоштовно. Ця кінцева точка створює або отримує WAV-адресу наявної пісні й не списує баланс.

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

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

Headers

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

maxAttempts і intervalSeconds — обидва числа JSON; intervalSeconds вимірюється в секундах, а не в мілісекундах, і зазвичай достатньо типових значень. Вони керують лише тим, скільки разів і з яким інтервалом ця кінцева точка внутрішньо чекає готовності WAV; на стан самої задачі генерації вони не впливають.

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

curl -X POST https://www.suno-api.io/api/music/wav \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "audioId": "clip_id",
    "maxAttempts": 24,
    "intervalSeconds": 5
  }'

Відповідь

{
  "code": 200,
  "message": "success",
  "data": {
    "audioId": "clip_id",
    "status": "complete",
    "wavUrl": "https://media.code-go.com/assets/example.wav"
  }
}

Примітки

Створення та пошук WAV сервер обирає автоматично за записом про пісню; клієнту не потрібно передавати дані акаунта.

Звичайні пісні та розділені доріжки використовують той самий контрольований шлях доставки медіа. WAV спершу завантажується й записується на диск через CN2, а data.wavUrl в успішній відповіді повертає лише контрольовану адресу CDN — ніколи тимчасову адресу джерела Suno або S3.

Якщо WAV-ресурс у стані ready вже є, його використовують повторно, без повторного запиту до Suno й повторного переміщення файлів. Ще не підготовлений WAV не розкривається через /api/music/query як адреса Suno/S3; його готують на вимогу лише після виклику цієї кінцевої точки або єдиної кінцевої точки завантаження.

⚠️ Термін дії WAV-адреси: 7 днів — збережіть вчасно. Повернутий data.wavUrl надається об'єктним сховищем платформи й типово втрачає чинність через 7 днів (файл вилучають, а стара адреса повертає 404). Збережіть WAV у власне сховище в цей термін; після завершення викличте цю кінцеву точку знову, щоб отримати нову дійсну адресу.

Якщо ресурс пісні тимчасово недоступний, кінцева точка повертає 409. Спробуйте пізніше; сервер не повертає нестабільні тимчасові адреси.