Skip to main content
GET
Aturan umum Suno V6 dan kueri tugas
Semua API pembuatan, pengeditan, dan alat Suno memakai tugas asinkron: kirim operasi, dapatkan task_id, lalu kueri hasil melalui API halaman ini.

Autentikasi

string
wajib
Autentikasi Bearer Token: Authorization: Bearer <YOUR_API_KEY>.
Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key.

Versi V6 dan pemilihan model

Model publik mendukung versi berikut:
  • v6
  • v6-wild
  • v6-mini
Endpoint utama memerlukan version atau custom_model_id dari tugas pembuatan model. Operasi edit yang mendukung versi memakai v6 jika version dihilangkan. Jangan kirim version publik bersama custom_model_id.
custom: true memilih mode lirik kustom, sedangkan custom_model_id memilih model terlatih. Keduanya berbeda; mode lirik tidak otomatis memakai tarif model kustom.

Opsi umum pembuatan V6

Kirim field berikut hanya jika dicantumkan oleh endpoint terkait: Hilangkan field yang tidak didukung dan jangan kirim max_mode: false ke semua operasi. variety dan Max terpisah; variety: "max" tidak mengaktifkan tagihan Max.

Batas teks dan bobot

Permintaan operasi baru memakai weirdness; weirdness_constraint adalah alias kompatibilitas. Generasi utama tetap memakai weirdness_constraint. Panjang dihitung dalam karakter Unicode.

Trek sumber referensi

Berdasarkan karya yang sudah ada:
  • task_id: ID tugas API Mart untuk trek audio keluaran.
  • audio_index: posisi asli dalam data.result.music[] tugas sumber, mulai dari 1; default 1.
Tampilkan jumlah elemen array yang sebenarnya, jangan tetapkan menjadi 2. Walau urutan tampilan berubah, operasi berikutnya harus memakai indeks hasil asli.
Permintaan baru mereferensikan trek sumber dengan task_id + audio_index; audio_id, music_id, atau audio_url tidak dapat menggantikannya. Sumber yang tidak ditemukan atau indeks di luar rentang mengembalikan 400.

Respons pengiriman

Baca ID tugas dari data[0].task_id. submitted hanya berarti tugas diterima, bukan berarti audio akhir atau hasil lain sudah tersedia.

Kueri tugas

GET /v1/music/tasks/{task_id} Tambahkan ?language=zh untuk memperoleh terjemahan pesan kegagalan yang tersedia. Parameter ini tidak mengubah bahasa lagu atau lirik.
string
wajib
ID tugas yang dikembalikan API pengiriman.
Tunggu sekitar 3 detik, lalu kueri setiap 5–10 detik hingga data.status menjadi completed atau failed. ID yang sama dapat dipakai setelah halaman dimuat ulang. Jangan mengirim ulang POST berbayar otomatis karena timeout jaringan.

Respons kueri

integer
Kode status respons.
object
Informasi tugas.

Pemrosesan hasil

  • Hasil musik biasanya berada di data.result.music[], tetapi unduhan, lirik, MIDI, Persona, dan model kustom memiliki struktur masing-masing.
  • duration adalah durasi aktual dan dapat berbentuk desimal; durasi target belum tentu sama persis dengan hasil akhir.
  • Nilai bobot 0 valid dan tidak boleh disembunyikan oleh pemeriksaan falsy JavaScript.
  • audio_url tidak selalu berakhiran .mp3. Putar atau unduh memakai URL yang benar-benar dikembalikan.
  • Jika status="unknown", simpan ID tugas dan izinkan penyegaran manual tanpa membuat tugas baru secara otomatis.
AbortController dapat menghentikan permintaan browser dan polling, tetapi tidak membatalkan tugas server. Belum ada endpoint untuk membatalkan tugas Suno yang dikirim.