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. Повторите попытку позже; сервер не возвращает нестабильные временные адреса.