Langsung ke konten utama
POST

Authorizations

Authorization
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

model
string
default:"suno"
Model audio. Saat ini kirim suno (jika tidak dikirim, default suno).
audio_urls
array
wajib
Array berisi 1–4 URL audio yang dapat diakses secara publik.
version
string
default:"v5.5"
Versi pembuatan: v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, memengaruhi kualitas audio dan penagihan; jika tidak dikirim, default v5.5.
prompt
string
Lirik / konten.
title
string
Judul.
tags
string
Tag gaya.
negative_tags
string
Tag gaya yang dikecualikan.
style_weight
number
Bobot gaya, 0.001.00.
weirdness_constraint
number
Bobot kreativitas, 0.001.00 (alias weirdness).
audio_weight
number
Bobot audio, 0.001.00.
vocal_gender
string
Jenis kelamin vokal: Male / Female.
auto_lyrics
boolean
true=menulis ulang lirik yang diberikan secara kreatif.
Mengambil hasil: Antarmuka ini adalah tugas asinkron. Setelah pengiriman, Anda mendapatkan task_id; lakukan polling GET /v1/music/tasks/{task_id} dengan interval 3–5 detik hingga status menjadi completed atau failed (pembuatan musik biasanya 30–120 detik; selama pembuatan, status adalah pending dan progress berjalan: antre 10 → siap 50 → selesai 100). Setelah selesai, ambil audio_url dari data.result.music[]. Jika gagal, data.error.message berisi alasannya dan kuota yang dipotong di muka otomatis dikembalikan.

Response

code
integer
Kode status respons
data
array
Array data yang dikembalikan