Remaster-API

Aktualisiert am 2026-09-18 · Suno-API-Team

Beschreibung des Endpunkts

Remaster erzeugt aus einem fertigen Song eine „remasterte Version" mit besserer Audioqualität. Es werden 2 Versionen auf einmal zurückgegeben, und der Upstream hängt automatisch (Remastered) an den Titel an.

Endpunkt: POST /api/music/remaster

Abrechnung: Kostenpflichtig, abgerechnet nach dem angeforderten Modell (standardmäßig suno-v6, 0,6 CNY pro Aufruf); der tatsächlich berechnete Betrag folgt der Preis-Konfiguration im Backoffice.

Zum Modell: Remaster nutzt einen eigenen Upstream-Endpunkt und ein eigenes Remaster-Modell, das die Plattform fest vorgibt und das sich nicht mit model ändert; das model in der Anfrage dient nur der Preisberechnung und Kanalwahl, und es wird empfohlen, suno-v6 explizit zu übergeben.

Wartezeiten und Timeouts (wichtig): Dies ist ein synchroner Endpunkt — die Bestellung wird erst angenommen und dem Remaster übergeben, wenn die Antwort eintrifft. Setzen Sie den Client-Timeout auf 300 Sekunden oder mehr; keine Antwort bedeutet nicht, dass nichts remastert wurde, und wiederholen Sie nicht direkt nach einem Timeout (das dupliziert die Bestellung und berechnet erneut). Wenn die Verbindung abbrach, prüfen Sie später mit GET /api/music/songs.

Authentifizierung

Anfrageparameter

audio_id, source_clip_id und sourceClipId sind gleichwertige Schreibweisen von song_id; verwenden Sie eine davon.

Beispielanfrage

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

Wenn Ihnen die Standardeinstellungen genügen, übergeben Sie nur den Quellsong — das entspricht variation_category: normal + style_profile: boost:

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

Antwort

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "remastered_clip_id_1",
        "song_title": "Titel des Quellsongs (Remastered)",
        "status": "processing"
      },
      {
        "song_id": "remastered_clip_id_2",
        "song_title": "Titel des Quellsongs (Remastered)",
        "status": "processing"
      }
    ]
  }
}

Ein Aufruf liefert 2 remasterte Versionen. Speichern Sie beide clips[].song_id und fragen Sie die API zum Abfragen von Songs ab, bis der Status complete ist, bevor Sie das Audio holen.

Hinweise

• Der Quellsong muss abgeschlossen und im Zugriffsbereich des aktuellen API-Schlüssels sein; externes Quellmaterial wird automatisch auf das ausführende Konto synchronisiert.
• Remaster erneuert nur die Audioqualität: Um Stil, Arrangement oder Gesang zu ändern, nutzen Sie Stil verstärken, Hochladen und covern oder die Remix-Endpunkte.
• Je größer variation_category ist, desto stärker weicht die remasterte Version vom Quellsong ab; probieren Sie vor einer echten Auslieferung zuerst normal und erhöhen Sie dann.