API generowania/pobierania WAV

Zaktualizowano 2026-09-18 · zespół Suno-API

Opis punktu końcowego

Punkt końcowy WAV generuje lub pobiera adres bezstratnego dźwięku WAV dla istniejącego utworu.

Punkt końcowy: POST /api/music/wav

Rozliczenie: Bezpłatne. Ten punkt końcowy generuje lub pobiera adres WAV istniejącego utworu i nie pobiera środków.

Czasy oczekiwania i limity czasu (ważne): to punkt końcowy synchroniczny — zamówienie zostaje przyjęte dopiero, gdy przyjdzie odpowiedź. Z pomiarów: większość żądań odpowiada w 1-3 sekundy, około 10% przekracza 30 sekund, a najdłuższe trwa około 230 sekund. Ustaw limit czasu klienta na 300 sekund lub więcej; brak odpowiedzi nie oznacza, że nic nie zostało wygenerowane, a ponawianie od razu po limicie czasu nie jest zalecane. Jeśli połączenie się zerwało, sprawdź później przez GET /api/music/songs. Zobacz „Czasy oczekiwania i ustawienia limitu czasu" w Przeglądzie nowego API.

Parametry żądania

Headers

Parametry body

maxAttempts i intervalSeconds to liczby JSON; intervalSeconds jest wyrażony w sekundach, a nie w milisekundach, i zwykle wystarczą wartości domyślne. Sterują one tylko tym, ile razy i w jakich odstępach ten punkt końcowy czeka wewnętrznie na gotowość WAV; nie zmieniają stanu samego zadania generowania.

Przykład żądania

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
  }'

Odpowiedź

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

Uwagi

Generowanie i sprawdzanie WAV serwer wybiera automatycznie na podstawie rekordu utworu; klient nie musi podawać żadnych informacji o koncie.

Zwykłe utwory i rozdzielone ścieżki korzystają z tej samej kontrolowanej ścieżki dostarczania mediów. WAV jest najpierw pobierany i zapisywany na dysku przez CN2, a data.wavUrl w udanej odpowiedzi zwraca wyłącznie kontrolowany adres CDN — nigdy tymczasowy adres źródłowy Suno lub S3.

Jeśli istnieje już zasób WAV w stanie ready, jest używany ponownie, bez ponownego pytania Suno i ponownego przenoszenia plików. WAV nieprzygotowany nie jest udostępniany jako adres Suno/S3 przez /api/music/query; jest przygotowywany na żądanie dopiero po wywołaniu tego punktu końcowego lub jednolitego punktu pobierania.

⚠️ Ważność adresu WAV: 7 dni — zapisz go na czas. Zwracany data.wavUrl udostępnia magazyn obiektów platformy i domyślnie wygasa po 7 dniach (plik jest odzyskiwany, a stary adres zwraca 404). Zapisz WAV we własnym magazynie w tym terminie; po wygaśnięciu wywołaj ten punkt końcowy ponownie, aby otrzymać nowy ważny adres.

Jeśli zasób utworu jest tymczasowo niedostępny, punkt końcowy zwraca 409. Spróbuj ponownie później; serwer nie zwraca niestabilnych adresów tymczasowych.