Remaster-API
Beskrivning av ändpunkten
Remaster skapar en "remastrad version" med bättre ljudkvalitet av en färdig låt. Den ger 2 versioner på en gång, och uppströms lägger automatiskt till (Remastered) i titeln.
Ändpunkt: POST /api/music/remaster
Fakturering: Betalt, debiteras enligt den begärda modellen (standard suno-v6, 0,6 CNY per anrop); det faktiskt debiterade beloppet följer prisinställningen i backoffice.
Om modellen: remaster använder en dedikerad uppströmsändpunkt och en dedikerad remastermodell, fastställda av plattformen och oberoende av model; model i begäran används bara för pris och kanalval, och det rekommenderas att skicka suno-v6 uttryckligen.
Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till remaster först när svaret kommer. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget remastrades, och försök inte igen direkt efter en timeout (det duplicerar beställningen och debiterar igen). Om anslutningen bröts, kontrollera senare med
GET /api/music/songs.
Autentisering
| Parameter | Typ | Krävs | Anmärkningar |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Begäransparametrar
| Parameter | Typ | Krävs | Standard | Anmärkningar |
|---|---|---|---|---|
| song_id | string | ja | - | ID:t för källåten som ska remastras; den måste vara klar och åtkomlig för den aktuella API-nyckeln |
| model | string | nej | suno-v6 | Modellnamn mot kund: suno-v6, suno-v6-wild eller suno-v6-mini; endast för pris och kanal |
| variation_category | string | nej | normal | Variantens styrka: subtle, normal, high (det gamla värdet low motsvarar subtle) |
| style_profile | string | nej | boost | Klangstil: natural, boost, clarity |
| tags | string | nej | - | Reserverat fält; är det inte tomt skickas det vidare till uppströms |
| source_audio_url | string | nej | - | Adress till källjudet, när källåten kommer från ett externt konto |
| source_file_name | string | nej | - | Källfilens namn, när källåten kommer från ett externt konto |
| source_title | string | nej | - | Källtitel, när källåten kommer från ett externt konto |
audio_id, source_clip_id och sourceClipId är likvärdiga stavningar av song_id; använd någon av dem.
Exempelbegäran
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"
}'
Om standardvärdena räcker, skicka bara källåten — det motsvarar variation_category: normal + style_profile: boost:
{ "model": "suno-v6", "song_id": "source_song_id" }
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "remastered_clip_id_1",
"song_title": "Källåtens titel (Remastered)",
"status": "processing"
},
{
"song_id": "remastered_clip_id_2",
"song_title": "Källåtens titel (Remastered)",
"status": "processing"
}
]
}
}
Ett anrop ger 2 remastrade versioner. Spara båda clips[].song_id och fråga API för låtfrågor och historik tills statusen är complete innan du hämtar ljudet.
Noter
- Källåten måste vara klar och ligga inom den aktuella API-nyckelns åtkomstomfång; externt källmaterial synkas automatiskt till det körda kontot.
- Remaster gör bara om ljudkvaliteten: för att byta stil, arrangemang eller sång använder du förstärk stil, ladda upp och gör cover eller Remix-ändpunkterna.
- Ju högre
variation_category, desto mer skiljer sig den remastrade versionen från källåten; provanormalförst och höj sedan, före en riktig leverans.
Skaffa en API-nyckel
Skapa en API-nyckel i konsolen efter registreringen. Varje generering kostar 0,6 ¥ och returnerar 2 spår, nedladdningar är obegränsade och inget telefonnummer krävs.
Hämta API-nyckel Tillbaka till översikten