Songtekstgeneratie-API

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

Beschrijving van het endpoint

Songtekstgeneratie maakt of herschrijft songteksten op basis van een thema, de context van bestaande teksten en stijlvereisten. Dit endpoint is al bijgewerkt naar het nieuwste contract voor songtekstgeneratie en kan direct worden gebruikt voor generatie in de professionele modus.

Endpoint: POST /api/lyrics/generate

Facturering: Gratis binnen het quotum (maximaal 10 aanroepen per minuut en 300 per dag per gebruiker); boven het gratis quotum kost het 0,1 CNY per aanroep.

Overschrijding herkennen: bij overschrijding van het gratis quotum loopt het verzoek gewoon door en bevatten de antwoordheaders X-Suno-Helper-Free: false en X-Suno-Helper-Over-Limit: minute (of day), zodat de client kan melden dat deze aanroep is gefactureerd.

Aanbevolen model: suno-v6. Beschikbaar zijn suno-v6, suno-v6-wild en suno-v6-mini.

Authenticatie

Verzoekparameters

instruction accepteert ook de oude velden theme en prompt. metadata.lyrics_model staat standaard op default en metadata.enable_thinking staat standaard op false.

Taalbeheer

Dit endpoint heeft geen apart language-verzoekveld. De taal van de tekst wordt bepaald door de inhoud van instruction; style kan alleen een ondersteunende rol spelen.

Geef voor een Chinese tekst de doeltaal expliciet aan in instruction, bijvoorbeeld:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

U kunt ook "Write the lyrics in Chinese about ..." schrijven. Voor een Engelse tekst schrijft u "请用英文写歌词" of "Write the lyrics in English". Als u alleen een Engels thema doorgeeft zonder de doeltaal te vermelden, kan het resultaat Engels zijn.

Voorbeeldverzoek

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Een Nederlandse tekst over het examenjaar en opnieuw beginnen",
    "style": "poprock, oprecht, pakkend refrein",
    "title": "Opnieuw beginnen",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Antwoord

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nDe wind gaat over het plein\nWij zwaaien het gisteren vaarwel",
    "edited_lyrics": "[Verse]\nDe wind gaat over het plein\nWij zwaaien het gisteren vaarwel",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics is de volledige tekst die in het songtekstveld ingevuld moet worden. lyrics_id en lyrics_request_id zijn bedoeld voor het volgen en kunnen leeg zijn afhankelijk van wat het endpoint teruggeeft; behandel ze niet als nummer-ID's.

Compatibiliteitsopmerkingen

• De oude velden theme en prompt werken nog en worden op instruction afgebeeld.
• De reeks endpoints songtekstproject / tekstschrijver is stopgezet: als u gegenereerde resultaten wilt bewaren, slaat u de door het endpoint teruggegeven edited_lyrics zelf op.