API voor het genereren van geluidseffecten
Beschrijving van het endpoint
Geluidseffecten genereren een paar seconden audio, geen nummer. Ze zijn geschikt voor korte geluiden zoals donder, regendruppels of een impact, en ook voor overgangseffecten, sfeergeluiden en drumloops; de meeste duren korter dan 5 seconden en de langste ongeveer 20 seconden. Zowel de eenmalige als de loop-modus wordt ondersteund.
Endpoint: POST /api/music/sounds
Facturering: Betaald, momenteel standaard 0,6 CNY per aanroep. Het daadwerkelijk afgeschreven bedrag volgt de huidige prijsconfiguratie in de backoffice.
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.
Verzoekparameters
Headers
| Parameter | Type | Verplicht | Opmerkingen |
|---|---|---|---|
| Authorization | string | ja | Bearer YOUR_API_KEY |
| Content-Type | string | ja | application/json |
Body-parameters
| Parameter | Type | Verplicht | Standaard | Opmerkingen |
|---|---|---|---|---|
| model | string | nee | suno-v6 | Modelnaam voor klanten: suno-v6, suno-v6-wild of suno-v6-mini |
| description | string | ja | - | Beschrijf het geluid dat u wilt; korte Engelse zinnen werken het betrouwbaarst, bijvoorbeeld cinematic whoosh transition, bright impact |
| title | string | nee | - | Titel; als deze niet wordt meegestuurd, kan hij uit de beschrijving worden gegenereerd |
| type | string | nee | one_shot | Type: one_shot (eenmalig) of loop (herhaling) |
| loop | boolean | nee | false | Of het in een loop wordt afgespeeld; gelijk aan type op loop zetten |
| bpm | number | nee | - | BPM; moet een getal groter dan 0 zijn. Een ongeldige waarde geeft 400 (invalid_sound_bpm) en wordt niet stil genegeerd |
| key | string | nee | - | Toonaard, in de vorm van een notenaam (C-B) plus optioneel #/b plus optioneel Major/Minor, bijvoorbeeld C Major, C#m, Bb; leeg of any betekent geen beperking. Een ongeldige waarde geeft 400 (invalid_sound_key) |
Voorbeeldverzoek
curl -X POST https://www.suno-api.io/api/music/sounds \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "suno-v6",
"description": "cinematic whoosh transition, bright impact",
"title": "cinematic whoosh",
"type": "one_shot",
"loop": false,
"bpm": 120,
"key": "C"
}'
Antwoord
Er wordt een array van nummers teruggegeven; de velden zijn gelijk aan de algemene nummer-antwoordvelden in het Overzicht van de nieuwe API.
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