Fade-in/out-API (toning)
Beskrivning av ändpunkten
Fade in/out lägger till en successivt starkare (fade-in) eller svagare (fade-out) effekt i en befintlig låt.
Ändpunkt: POST /api/music/fade
Fakturering: Betalt, debiteras efter den begärda modellen; det faktiskt debiterade beloppet följer prisinställningen i backoffice.
Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.
Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till generering först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, 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. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.
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 |
|---|---|---|---|---|
| model | string | ja | - | Modellnamn mot kund: suno-v6, suno-v6-wild eller suno-v6-mini |
| source_clip_id | string | ja | - | Den riktiga song_id för källlåten; den måste vara klar och nåbar med den aktuella API-nyckeln |
| direction | string | ja | - | in för tona in, out för tona ut |
| duration_seconds | number | ja | - | Toningslängd i sekunder; måste vara större än 0 |
| song_title | string | nej | - | Titel för resultatet |
Exempelbegäran
curl -X POST https://www.suno-api.io/api/music/fade \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"direction": "out",
"duration_seconds": 3,
"song_title": "Uttonad version"
}'
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Uttonad version",
"status": "processing"
}
]
}
}
Ett anrop ger 1 resultat (redigeringsåtgärder skapar inte 2 låtar). Spara clips[].song_id och polla API för låtfrågor tills statusen är completed.
Noter
directionaccepterar barainellerout; en begäran kan ange en riktning.duration_secondsmåste vara större än 0 och mäts i sekunder.
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