API remasteringu (Remaster)

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

Opis punktu końcowego

Remastering regeneruje ukończony utwór jako «wersję zremasterowaną» o lepszej jakości dźwięku. Zwraca 2 wersje naraz, a upstream automatycznie dopisuje (Remastered) do tytułu.

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

Rozliczenie: Płatne, rozliczane według żądanego modelu (domyślnie suno-v6, 0,6 CNY za wywołanie); faktycznie pobrana kwota zależy od konfiguracji cen w panelu administracyjnym.

O modelu: remastering korzysta z dedykowanego punktu końcowego upstream i dedykowanego modelu remasteringu, ustalonych przez platformę i niezależnych od model; model w żądaniu służy tylko do ceny i wyboru kanału, więc zaleca się jawne przekazanie suno-v6.

Czasy oczekiwania i limity czasu (ważne): to punkt końcowy synchroniczny — zamówienie zostaje przyjęte i przekazane do remasteringu dopiero, gdy przyjdzie odpowiedź. Ustaw limit czasu klienta na 300 sekund lub więcej; brak odpowiedzi nie oznacza, że nic nie zremasterowano, a ponawianie od razu po limicie czasu duplikuje zamówienie i pobiera opłatę ponownie. Jeśli połączenie się zerwało, sprawdź później przez GET /api/music/songs.

Uwierzytelnianie

Parametry żądania

audio_id, source_clip_id i sourceClipId to równoważne zapisy song_id; użyj jednego z nich.

Przykład żądania

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

Jeśli wystarczą wartości domyślne, przekaż tylko utwór źródłowy — odpowiada to variation_category: normal + style_profile: boost:

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

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Tytuł utworu źródłowego (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Tytuł utworu źródłowego (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Jedno wywołanie zwraca 2 zremasterowane wersje. Zapisz oba clips[].song_id i odpytuj API zapytań o utwory i historii aż do stanu complete, zanim pobierzesz dźwięk.

Uwagi

• Utwór źródłowy musi być ukończony i znajdować się w zakresie dostępu bieżącego klucza API; zewnętrzny materiał źródłowy jest automatycznie synchronizowany z kontem wykonującym.
• Remastering odświeża wyłącznie jakość dźwięku: aby zmienić styl, aranżację lub wokal, użyj wzmacniania stylu, przesłania i coveru albo punktów Remix.
• Im większe variation_category, tym bardziej wersja zremasterowana różni się od utworu źródłowego; przed realną dostawą wypróbuj najpierw normal, a potem zwiększaj.