Ondersteunde modellen

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

Beschikbare generatiemodellen

Verzoeken gebruiken alleen de platformmodelnamen die hieronder staan. Andere namen worden niet geaccepteerd, ook niet als ze op een bestaand model lijken.

Aanbevolen standaardmodel: suno-v6.

Over het scheiden van stems

Het scheiden van stems is een vaste, zelfstandige functie: je hoeft geen generatiemodel te kiezen. Stuur gewoon het originele nummer en de scheidingsmodus mee (bijvoorbeeld two of twelve). Het aantal teruggegeven sporen is wat het antwoord vermeldt.

De parameter model

Bij de generatie-endpoints is model meestal optioneel:

• Weggelaten: gebruikt de standaardwaarde suno-v6.
• Opgegeven: moet suno-v6, suno-v6-wild of suno-v6-mini zijn.
• Alleen de modelnamen uit de tabel hierboven worden geaccepteerd.

Minimaal generatievoorbeeld

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  --max-time 300 \
  -d '{
    "description": "een vrolijk folknummer over de eerste dag van de lente",
    "model": "suno-v6"
  }'

Wachttijden en timeouts (belangrijk): generatie-endpoints zijn synchroon — 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 (de --max-time 300 in het voorbeeld); 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.

Voorbeeld met een V6-variant

{
  "model": "suno-v6-wild",
  "description": "een elektronisch nummer met een experimentele structuur"
}

Uitgeschakelde modellen

Deze modellen accepteren geen nieuwe verzoeken meer:

• suno-v2
• suno-v3
• suno-v3-5
• suno-v4
• suno-v4-5
• suno-v4-5-all
• suno-v4-5-plus
• suno-v5
• suno-v5-5

Oudere nummers en taken kunnen nog de oude model_name of model_version tonen. Dat is historische data: het betekent niet dat het oude model nieuwe verzoeken accepteert.

Voor compatibiliteit met bestaande clients wordt een verzoek met een uitgeschakeld model verwerkt met het huidige standaardmodel suno-v6 in plaats van geweigerd. De taak registreert dan ook suno-v6 en er wordt geen fout "model niet beschikbaar" teruggegeven. Werk je voorbeelden toch zo snel mogelijk bij naar de huidige namen.

Modellen opvragen

GET /v1/models hoort in elk geval deze muziekmodellen te bevatten:

{
  "object": "list",
  "data": [
    { "id": "suno-v6", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-wild", "object": "model", "owned_by": "suno" },
    { "id": "suno-v6-mini", "object": "model", "owned_by": "suno" }
  ]
}

Het antwoord kan ook tekstmodellen, compatibiliteitsroutes of interne modellen bevatten. Verwar die niet met de V6-modellen voor muziekgeneratie.

De juiste V6-variant kiezen

Voor de meeste integraties is het standaardmodel voldoende. De drie varianten verschillen in trouw aan de prompt en in de variatie van het resultaat.

Omdat elke uitvoering twee nummers oplevert, is een praktische werkwijze: schetsen met suno-v6-mini en de goedgekeurde prompt uitvoeren met suno-v6 om de versie te kiezen die je publiceren wilt.

Kosten en terugbetaling

De prijs geldt per verzoek, niet per model: elke uitvoering kost ¥0,6 en levert twee nummers op. Mislukte generaties worden automatisch terugbetaald, dus een mislukte poging verbruikt geen saldo. Downloads zijn onbeperkt en worden nooit apart in rekening gebracht.