Reverse-API (baklänges)
Beskrivning av ändpunkten
Reverse spelar en befintlig låt baklänges och skapar en ny version.
Ändpunkt: POST /api/music/reverse
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 |
| song_title | string | nej | - | Titel för resultatet |
Exempelbegäran
curl -X POST https://www.suno-api.io/api/music/reverse \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"source_clip_id": "source_song_id",
"song_title": "Omvänd version"
}'
Svar
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Omvänd 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
source_clip_idmåste vara ett riktigt, avslutat låt-ID som den aktuella API-nyckeln kan nå.- Resultatets längd motsvarar oftast källlåten.
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