API för låttextgenerering

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Låttextgenerering skapar eller skriver om låttexter utifrån ett tema, kontext från befintlig text och stilönskemål. Den här ändpunkten är redan uppdaterad till det senaste kontraktet för låttextgenerering och kan användas direkt för generering i professionellt läge.

Ändpunkt: POST /api/lyrics/generate

Fakturering: Kostnadsfritt inom kvoten (högst 10 anrop per minut och 300 per dag per användare); över den kostnadsfria kvoten kostar det 0,1 CNY per anrop.

Upptäcka överskridande: när den kostnadsfria kvoten överskrids körs begäran ändå normalt och svarsrubrikerna innehåller X-Suno-Helper-Free: false och X-Suno-Helper-Over-Limit: minute (eller day), så klienten kan tala om att detta anrop debiterades.

Rekommenderad modell: suno-v6. suno-v6, suno-v6-wild och suno-v6-mini är tillgängliga.

Autentisering

Begäransparametrar

instruction accepterar även de gamla fälten theme och prompt. metadata.lyrics_model är som standard default och metadata.enable_thinking som standard false.

Språkstyrning

Den här ändpunkten har inget separat language-fält. Textens språk avgörs av innehållet i instruction; style kan bara spela en stödjande roll.

Ange målspråket uttryckligen i instruction för att få en kinesisk text, till exempel:

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

Du kan också skriva "Write the lyrics in Chinese about ...". För engelsk text skriver du "请用英文写歌词" eller "Write the lyrics in English". Om du bara skickar ett engelskt tema utan att ange målspråket kan resultatet bli engelskt.

Exempelbegäran

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": "En svensk text om studenttiden och att börja om",
    "style": "poprock, uppriktigt, minnesvärd refräng",
    "title": "Börja om",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Svar

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nVinden drar över skolgården\nVi vinkar farväl till igår",
    "edited_lyrics": "[Verse]\nVinden drar över skolgården\nVi vinkar farväl till igår",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics är den fullständiga text som ska föras in i textfältet. lyrics_id och lyrics_request_id används för spårning och kan vara tomma beroende på vad ändpunkten returnerar; behandla dem inte som låt-ID.

Kompatibilitetsnoter

• De gamla fälten theme och prompt fungerar fortfarande och mappas till instruction.
• Serien av ändpunkter för låttextprojekt / textförfattare har lagts ned: om du behöver spara genererade resultat sparar du själv den edited_lyrics som ändpunkten returnerar.