API de generare a versurilor

Actualizat pe 2026-09-18 · echipa Suno-API

Descrierea endpoint-ului

Generarea versurilor creează sau rescrie versuri pornind de la o temă, contextul versurilor existente și cerințe de stil. Acest endpoint a fost deja actualizat la cel mai recent contract de generare a versurilor și poate fi folosit direct pentru generarea în modul profesionist.

Endpoint: POST /api/lyrics/generate

Facturare: Gratuit în limita cotei (cel mult 10 apeluri pe minut și 300 pe zi per utilizator); peste cota gratuită costă 0,1 CNY per apel.

Detectarea depășirii: când cota gratuită este depășită, cererea se execută oricum normal, iar anteturile răspunsului includ X-Suno-Helper-Free: false și X-Suno-Helper-Over-Limit: minute (sau day), astfel încât clientul poate anunța că acest apel a fost taxat.

Model recomandat: suno-v6. Sunt disponibile suno-v6, suno-v6-wild și suno-v6-mini.

Autentificare

Parametrii cererii

instruction acceptă și câmpurile vechi theme și prompt. metadata.lyrics_model este implicit default, iar metadata.enable_thinking implicit false.

Controlul limbii

Acest endpoint nu are un câmp de cerere language separat. Limba versurilor este decisă de conținutul lui instruction; style poate avea doar un rol auxiliar.

Pentru versuri în chineză, indică limba țintă explicit în instruction, de exemplu:

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

Poți scrie și "Write the lyrics in Chinese about ...". Pentru versuri în engleză scrie "请用英文写歌词" sau "Write the lyrics in English". Dacă trimiți doar o temă în engleză fără să indici limba țintă, rezultatul poate fi în engleză.

Exemplu de cerere

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": "Versuri în română despre finalul școlii și un nou început",
    "style": "pop rock, sincer, refren memorabil",
    "title": "Un nou început",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Răspuns

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nVântul trece peste curte\nNe luăm rămas-bun de la ieri",
    "edited_lyrics": "[Verse]\nVântul trece peste curte\nNe luăm rămas-bun de la ieri",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics este textul complet care trebuie scris în caseta de versuri. lyrics_id și lyrics_request_id servesc pentru urmărire și pot fi goale în funcție de ce returnează endpointul; nu le trata ca ID-uri de piesă.

Note de compatibilitate

• Câmpurile vechi theme și prompt încă funcționează și sunt mapate la instruction.
• Seria de endpointuri proiect de versuri / textier a fost retrasă: dacă vrei să păstrezi rezultatele generate, salvează singur edited_lyrics returnat de endpoint.