API voor het toevoegen van instrumentale begeleiding

Bijgewerkt op 2026-09-18 · Suno-API-team

Beschrijving van het endpoint

Instrumentale begeleiding toevoegen herarrangeert een bestaand nummer, vult het aan met instrumenten of genereert een nieuwe begeleidingsstructuur.

Endpoint: POST /api/music/add-instrumental

Facturering: Betaald, gefactureerd volgens het opgevraagde model; het daadwerkelijk afgeschreven bedrag volgt de prijsconfiguratie in de backoffice.

Max Mode / Variety: dit endpoint ondersteunt de optionele parameters max_mode en variety (0-4). Met max_mode aan wordt deze aanroep tegen het dubbele tarief gefactureerd; variety kost niets extra. Wat ze betekenen en hoe u ze verstuurt, staat in de sectie "Geavanceerde parameters" van het Overzicht van de nieuwe API.

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

Verzoekparameters

Voorbeeldverzoek

curl -X POST https://www.suno-api.io/api/music/add-instrumental \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "lyrics": "",
    "style_tags": "cinematic, strings, acoustic guitar",
    "song_title": "Versie met versterkte begeleiding",
    "audio_weight": 1,
    "wait_completion": false
  }'

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Versie met versterkte begeleiding",
        "status": "pending"
      },
      {
        "song_id": "result_song_id_2",
        "song_title": "Versie met versterkte begeleiding",
        "status": "pending"
      }
    ]
  }
}

Eén aanroep levert 2 resultaten op (gefactureerd als 2 nummers); het voorbeeld toont er 2. Kijk naar de lengte van de clips-array en gebruik geen vast aantal iteraties. Sla clips[].song_id op en bevraag de API voor nummeropvraging en geschiedenis tot completed. Daarna kunt u afspelen of downloaden via audio_url; zie de API voor het genereren en ophalen van WAV en de overige download-endpoints.

Opmerkingen

• source_clip_id moet een echte, voltooide song-ID zijn die toegankelijk is voor de huidige API-sleutel; een plaatsvervanger als pending: kan niet worden gebruikt.
• Instrumentale begeleiding toevoegen is geen cover; gebruik voor een cover de API voor covers op basis van een bronclip.
• Wilt u een specifiek instrument of een specifieke track aan een bestaand nummer toevoegen, gebruik dan de API voor het toevoegen van een track.