Skip to main content
POST
custom mengatur cara field teks ditafsirkan. Dengan custom=true, prompt berisi lirik dan title, style, negative_tags, auto_lyrics, serta persona_id berlaku. Dengan custom=false, prompt berisi inspirasi dan field mode kustom diabaikan. style_weight, weirdness_constraint, audio_weight, dan vocal_gender divalidasi pada kedua mode.
Endpoint ini memakai nama field yang sedikit berbeda: style, bukan tags.

Authorizations

string
wajib
Semua antarmuka memerlukan autentikasi menggunakan Bearer TokenDapatkan API Key:Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key AndaSaat digunakan, tambahkan pada header permintaan:

Body

string
default:"suno"
Model audio. Saat ini kirim suno (jika tidak dikirim, default suno).
boolean
default:"false"
false=mode inspirasi; true=mode kustom (prompt sebagai lirik). Default false.
boolean
default:"false"
true=musik instrumental murni, tanpa vokal. Default false.
string
Versi publik: v6 / v6-wild / v6-mini. Field ini atau custom_model_id wajib; hilangkan saat memakai model kustom.
string
UUID lengkap tugas model kustom. Tidak dapat digunakan bersama version dan persona_id; jika diberikan, tarif model kustom berlaku.
string
Inspirasi/lirik. Wajib saat custom=false, maksimum 3.000 karakter; juga wajib saat custom=true dan instrumental=false, maksimum 5.000. Boleh dihilangkan untuk instrumental kustom.
string
Judul mode kustom, hingga 80 karakter. Diabaikan saat custom=false.
string
Tag gaya dalam mode kustom, hingga 1.000 karakter. Diabaikan saat custom=false.
string
Tag gaya negatif (gaya yang tidak Anda inginkan). Hanya berlaku saat custom=true.
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
string
ID gaya Persona. Hanya berlaku dengan custom=true dan tidak dapat digunakan bersama custom_model_id.
string
Jenis kelamin vokal: Male / Female (m / f / male / female juga diterima dan dinormalisasi otomatis oleh backend). Berlaku di kedua mode.
number
Bobot gaya, 0.00–1.00. Divalidasi dan berlaku pada kedua mode.
number
Skor kreativitas, 0.00–1.00. Divalidasi dan berlaku pada kedua mode.
number
Bobot audio, 0.00–1.00. Divalidasi dan berlaku pada kedua mode.
string
Variasi gaya: off / normal / high / extra / max. Opsional, tanpa nilai default tetap.
boolean
default:"false"
Apakah mode Max diaktifkan. Memerlukan custom=true dan dikenai biaya dua kali harga normal.
string
Format audio keluaran: mp3 / m4a / wav. Jika dihilangkan, layanan memilih default.
integer
Durasi target 10–360 detik. Hanya saat custom=true; durasi akhir mengikuti hasil tugas.
Ambil hasil: polling tugas asinkron setiap 3–5 detik. Pembuatan musik biasanya memerlukan 30–120 detik; status dapat pending atau processing dan progres tidak selalu berubah dalam interval tetap. Setelah selesai, baca audio_url dari data.result.music[] (juga tersedia image_url, video_url, title, duration, dan lainnya). Jika gagal, dana yang dipotong dikembalikan.

Response

integer
Kode status respons
array
Array data yang dikembalikan