Speed-API (snelheid)
Beschrijving van het endpoint
Speed wijzigt de afspeelsnelheid van een bestaand nummer en kan optioneel de toonhoogte behouden.
Endpoint: POST /api/music/speed
Facturering: Betaald, gefactureerd op basis van het opgevraagde model; het werkelijk afgeschreven bedrag volgt de prijsconfiguratie in de back-office.
Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.
Wachttijden en timeouts (belangrijk): dit is een synchroon endpoint — de opdracht wordt pas geaccepteerd en aan generatie overgedragen wanneer het antwoord binnenkomt. Gemeten: de meeste verzoeken antwoorden in 1-3 seconden, ongeveer 10% duurt langer dan 30 seconden en de langste is ongeveer 230 seconden. Zet de client-timeout op 300 seconden of meer; geen antwoord betekent niet dat er niets is gegenereerd, en probeer niet direct na een timeout opnieuw (dat dupliceert de opdracht en rekent opnieuw af). Als de verbinding wegviel, controleer later met
GET /api/music/songs. Zie "Wachttijden en timeout-instellingen" in het Overzicht van de nieuwe API.
Authenticatie
| Parameter | Type | Verplicht | Opmerkingen |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Verzoekparameters
| Parameter | Type | Verplicht | Standaard | Opmerkingen |
|---|---|---|---|---|
| model | string | ja | - | Modelnaam voor klanten: suno-v6, suno-v6-wild of suno-v6-mini |
| source_clip_id | string | ja | - | De echte song_id van het bronnummer; het moet afgerond en toegankelijk zijn voor de huidige API-sleutel |
| speed_multiplier | number | ja | - | Snelheidsfactor; moet positief zijn, maximaal vier decimalen |
| keep_pitch | boolean | nee | false | Of de toonhoogte behouden blijft; bij true verandert de zangtoonhoogte niet mee met de snelheid |
| song_title | string | nee | - | Titel van het resultaat |
Voorbeeldverzoek
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": "Versie met gewijzigde snelheid"
}'
Antwoord
{
"code": 200,
"message": "success",
"data": {
"clips": [
{
"song_id": "result_song_id",
"song_title": "Versie met gewijzigde snelheid",
"status": "processing"
}
]
}
}
Eén aanroep levert 1 resultaat (bewerkingsacties maken geen 2 nummers). Bewaar clips[].song_id en poll de API voor nummeropvraging tot de status completed is.
Opmerkingen
speed_multipliermoet positief zijn met maximaal vier decimalen; meer decimalen geven HTTP 400 vóór enige facturering.- De duur van het resultaat is ongeveer de oorspronkelijke duur gedeeld door de factor.
Een API-sleutel aanvragen
Maak na je registratie een API-sleutel aan in de console. Elke generatie kost ¥0,6 en levert 2 nummers op, downloads zijn onbeperkt en een telefoonnummer is niet nodig.
API-sleutel ophalen Terug naar overzicht