Speed-API (hastighet)
Beskrivning av ändpunkten
Speed ändrar uppspelningshastigheten för en befintlig låt och kan bevara tonhöjden.
Ändpunkt: POST /api/music/speed
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 |
| speed_multiplier | number | ja | - | Hastighetsfaktor; måste vara positiv, högst fyra decimaler |
| keep_pitch | boolean | nej | false | Om tonhöjden ska bevaras; med true ändras sångtonhöjden inte med hastigheten |
| song_title | string | nej | - | Titel för resultatet |
Exempelbegäran
curl -X POST https://www.suno-api.io/api/music/speed \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"speed_multiplier": 1.2,
"keep_pitch": true,
"song_title": "Hastighetsändrad version"
}'
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Hastighetsändrad 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
speed_multipliermåste vara positiv med högst fyra decimaler; fler decimaler ger HTTP 400 före någon debitering.- Resultatets längd är ungefär den ursprungliga längden delad med faktorn.
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