Fade-in/out-API (in-/uitfaden)

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

Beschrijving van het endpoint

Fade in/out voegt een in- of uitfade-effect toe aan een bestaand nummer (geleidelijk luider of zachter).

Endpoint: POST /api/music/fade

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

Verzoekparameters

Voorbeeldverzoek

curl -X POST https://www.suno-api.io/api/music/fade \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "source_clip_id": "source_song_id",
    "direction": "out",
    "duration_seconds": 3,
    "song_title": "Versie met uitfade"
  }'

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "clips": [
      {
        "song_id": "result_song_id",
        "song_title": "Versie met uitfade",
        "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

• direction accepteert alleen in of out; één verzoek kan maar één richting opgeven.
• duration_seconds moet groter zijn dan 0 en wordt in seconden gemeten.