API penjanaan lirik

Dikemas kini 2026-09-18 · pasukan Suno-API

Penerangan endpoint

Penjanaan lirik mencipta atau menulis semula lirik berdasarkan tema, konteks lirik sedia ada dan keperluan gaya. Endpoint ini sudah dinaik taraf kepada kontrak penjanaan lirik terkini dan boleh digunakan terus untuk penjanaan dalam mod profesional.

Endpoint: POST /api/lyrics/generate

Pengebilan: Percuma dalam kuota (maksimum 10 panggilan seminit dan 300 sehari bagi setiap pengguna); melebihi kuota percuma dikenakan 0.1 CNY setiap panggilan.

Mengesan lebihan: apabila kuota percuma dilampaui, permintaan tetap berjalan seperti biasa dan pengepala respons membawa X-Suno-Helper-Free: false serta X-Suno-Helper-Over-Limit: minute (atau day), jadi klien boleh memberitahu bahawa panggilan ini dicaj.

Model yang disyorkan: suno-v6. Tersedia suno-v6, suno-v6-wild dan suno-v6-mini.

Pengesahan

Parameter	Jenis	Wajib	Nota
Authorization	string	ya	`Bearer YOUR_API_KEY`
Content-Type	string	ya	`application/json`

Parameter permintaan

Parameter	Jenis	Wajib	Lalai	Nota
model	string	ya	-	Nama model untuk pelanggan: `suno-v6`, `suno-v6-wild` atau `suno-v6-mini`
instruction	string	ya	-	Tema lirik atau keperluan penjanaan
style	string	tidak	-	Keperluan gaya
title	string	tidak	-	Tajuk lagu atau kekangan tajuk
selected	string	tidak	`""`	Teks yang dipilih untuk ditulis semula
context_before	string	tidak	`""`	Konteks sebelumnya
context_after	string	tidak	`""`	Konteks selepasnya
mode	string	tidak	`apply_user_request`	Mod penjanaan lirik
references	array	tidak	`[]`	Senarai bahan rujukan
num_variants	integer	tidak	`null`	Bilangan variasi lirik yang dikehendaki
lyricist_id	string	tidak	`null`	ID penulis lirik tertentu (senarai penulis lirik telah dihentikan; integrasi baharu tidak disyorkan)
metadata	object	tidak	-	Parameter lanjutan; menyokong `lyrics_model` dan `enable_thinking`
lyrics_project_id	string	tidak	`null`	ID projek lirik sedia ada (siri projek lirik telah dihentikan; integrasi baharu tidak disyorkan)

instruction turut menerima medan lama theme dan prompt. metadata.lyrics_model lalai default dan metadata.enable_thinking lalai false.

Kawalan bahasa

Endpoint ini tiada medan permintaan language yang berasingan. Bahasa lirik ditentukan oleh kandungan instruction; style hanya memainkan peranan sokongan.

Untuk menjana lirik bahasa Cina, nyatakan bahasa sasaran secara jelas dalam instruction, contohnya:

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

Anda juga boleh menulis "Write the lyrics in Chinese about ...". Untuk lirik bahasa Inggeris, tulis "请用英文写歌词" atau "Write the lyrics in English". Jika hanya menghantar tema bahasa Inggeris tanpa menyatakan bahasa sasaran, hasilnya mungkin bahasa Inggeris.

Contoh permintaan

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": "Lirik bahasa Melayu tentang musim graduasi dan memulakan semula",
    "style": "pop rock, ikhlas, korus mudah diingati",
    "title": "Mula semula",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Respons

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nAngin melintasi padang\nKita melambai selamat tinggal pada semalam",
    "edited_lyrics": "[Verse]\nAngin melintasi padang\nKita melambai selamat tinggal pada semalam",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics ialah lirik lengkap yang perlu dimasukkan ke dalam kotak lirik. lyrics_id dan lyrics_request_id berguna untuk penjejakan dan mungkin kosong bergantung pada respons endpoint; jangan anggapnya sebagai ID lagu.

Nota keserasian

Medan lama theme dan prompt masih berfungsi dan dipetakan kepada instruction.
Siri endpoint projek lirik / penulis lirik telah dihentikan: jika perlu menyimpan hasil penjanaan, simpan sendiri edited_lyrics yang dipulangkan endpoint.

SeterusnyaAPI pengklonan suara dan penjanaan dengan suara yang ditetapkan (tidak disyorkan)

Dapatkan kunci API

Cipta kunci API dalam konsol selepas mendaftar. Setiap penjanaan berharga 0.6 ¥ dan mengembalikan 2 lagu, muat turun tanpa had dan nombor telefon tidak diperlukan.

Dapatkan kunci API Kembali ke gambaran