API pembuatan lirik

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Pembuatan lirik membuat atau menulis ulang lirik dari tema, konteks lirik yang sudah ada, dan persyaratan gaya. Endpoint ini sudah diperbarui ke kontrak pembuatan lirik terbaru dan bisa langsung dipakai untuk pembuatan dalam mode profesional.

Endpoint: POST /api/lyrics/generate

Biaya: Gratis dalam kuota (maksimal 10 panggilan per menit dan 300 per hari per pengguna); di atas kuota gratis dikenai 0,1 CNY per panggilan.

Mendeteksi kelebihan: saat kuota gratis terlampaui, permintaan tetap berjalan normal dan header respons membawa X-Suno-Helper-Free: false serta X-Suno-Helper-Over-Limit: minute (atau day), sehingga klien dapat memberi tahu bahwa panggilan ini ditagih.

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

Autentikasi

Parameter	Tipe	Wajib	Catatan
Authorization	string	ya	`Bearer YOUR_API_KEY`
Content-Type	string	ya	`application/json`

Parameter permintaan

Parameter	Tipe	Wajib	Default	Catatan
model	string	ya	-	Nama model untuk pelanggan: `suno-v6`, `suno-v6-wild`, atau `suno-v6-mini`
instruction	string	ya	-	Tema lirik atau persyaratan pembuatan
style	string	tidak	-	Persyaratan gaya
title	string	tidak	-	Judul lagu atau batasan judul
selected	string	tidak	`""`	Teks terpilih yang akan ditulis ulang
context_before	string	tidak	`""`	Konteks sebelumnya
context_after	string	tidak	`""`	Konteks sesudahnya
mode	string	tidak	`apply_user_request`	Mode pembuatan lirik
references	array	tidak	`[]`	Daftar materi referensi
num_variants	integer	tidak	`null`	Jumlah varian lirik yang diinginkan
lyricist_id	string	tidak	`null`	ID penulis lirik tertentu (daftar penulis lirik sudah dihentikan; integrasi baru tidak disarankan)
metadata	object	tidak	-	Parameter lanjutan; mendukung `lyrics_model` dan `enable_thinking`
lyrics_project_id	string	tidak	`null`	ID proyek lirik yang sudah ada (seri proyek lirik sudah dihentikan; integrasi baru tidak disarankan)

instruction juga menerima bidang lama theme dan prompt. metadata.lyrics_model default default, metadata.enable_thinking default false.

Kontrol bahasa

Endpoint ini tidak punya bidang permintaan language tersendiri. Bahasa lirik ditentukan oleh isi instruction; style hanya berperan sebagai pendukung.

Untuk menghasilkan lirik berbahasa Mandarin, sebutkan bahasa tujuan secara eksplisit di instruction, misalnya:

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

Kamu juga bisa menulis "Write the lyrics in Chinese about ...". Untuk lirik bahasa Inggris, tulis "请用英文写歌词" atau "Write the lyrics in English". Jika hanya mengirim tema bahasa Inggris tanpa menyebut bahasa tujuan, hasilnya bisa berbahasa Inggris.

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 Indonesia tentang musim kelulusan dan memulai kembali",
    "style": "pop rock, tulus, reff mudah diingat",
    "title": "Mulai kembali",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Respons

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

edited_lyrics adalah lirik lengkap yang harus dimasukkan ke kotak lirik. lyrics_id dan lyrics_request_id berguna untuk pelacakan dan bisa kosong tergantung respons endpoint; jangan anggap keduanya sebagai ID lagu.

Catatan kompatibilitas

Bidang lama theme dan prompt masih berfungsi dan dipetakan ke instruction.
Seri endpoint proyek lirik / penulis lirik sudah dihentikan: jika perlu menyimpan hasil pembuatan, simpan sendiri edited_lyrics yang dikembalikan endpoint.

BerikutnyaAPI kloning suara dan pembuatan dengan suara yang ditentukan (tidak disarankan)

Dapatkan kunci API

Buat kunci API di konsol setelah mendaftar. Setiap pembuatan berbiaya 0,6 ¥ dan menghasilkan 2 lagu, unduhan tidak terbatas, dan nomor telepon tidak diperlukan.

Ambil kunci API Kembali ke ringkasan