Langsung ke konten utama
POST
Mereferensikan trek sumber: mashup memerlukan tepat 2 trek sumber — tentukan via task_ids (array berisi tepat 2 task_id Anda), dengan audio_indexes opsional (array paralel yang menentukan item ke berapa dalam music[] tiap task, berbasis 1, default 1).
custom menentukan field mana yang berlaku: field yang ditulis pada mode yang salah diabaikan secara diam-diam oleh pihak hulu (tanpa error). Dengan custom=true, prompt (lirik), title, tags, negative_tags, auto_lyrics, style_weight, weirdness_constraint, audio_weight, dan persona_id berlaku sedangkan gpt_description diabaikan; dengan custom=false, hanya gpt_description yang dibaca (wajib dalam kasus itu — jika tidak ada, 400 dikembalikan saat pengiriman). vocal_gender berlaku pada kedua mode. Jika custom tidak dikirim, backend menyimpulkannya dengan urutan berikut: ada prompttrue; tidak ada prompt tetapi ada gpt_descriptionfalse; selain itu, ada tags/titletrue.

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).
task_ids
string[]
wajib
Array task_id Anda untuk 2 trek sumber (harus tepat 2; jumlah lain langsung mengembalikan 400 saat pengiriman).
audio_indexes
integer[]
Array paralel dengan task_ids, menentukan item ke berapa dalam music[] hasil tiap task (berbasis 1, default 1).
instrumental
boolean
default:"false"
Apakah murni instrumental (true=tanpa vokal); jika tidak dikirim, default false (dengan vokal).
version
string
default:"v5.5"
Versi pembuatan: v3.5 / v4 / v4.5 / v4.5+ / v4.5-all / v5 / v5.5, memengaruhi kualitas audio dan penagihan; default v5.5 jika tidak dikirim, dan nilai yang tidak valid langsung mengembalikan 400 saat pengiriman.
custom
boolean
true=mode kustom (prompt digunakan sebagai lirik); false=mode inspirasi (menggunakan gpt_description); jika tidak dikirim, disimpulkan dari konten (lihat peringatan di atas).
prompt
string
Lirik. Berlaku saat custom=true (diabaikan dalam mode inspirasi).
gpt_description
string
Prompt inspirasi. Wajib saat custom=false — jika tidak ada, permintaan gagal dengan 400 saat pengiriman (pihak hulu tidak dipanggil, tidak ada biaya yang dikenakan).
title
string
Judul. Hanya berlaku saat custom=true.
tags
string
Tag gaya. Hanya berlaku saat custom=true.
negative_tags
string
Tag gaya yang dikecualikan. Hanya berlaku saat custom=true.
auto_lyrics
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
style_weight
number
Bobot gaya, 0.001.00 (nilai di luar rentang langsung mengembalikan 400 saat pengiriman). Hanya berlaku saat custom=true.
weirdness_constraint
number
Bobot kreativitas, 0.001.00 (alias weirdness). Hanya berlaku saat custom=true.
audio_weight
number
Bobot audio, 0.001.00. Hanya berlaku saat custom=true.
vocal_gender
string
Jenis vokal: Male / Female. Berlaku pada kedua mode.
persona_id
string
Id gaya persona. Hanya berlaku saat custom=true.
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 bernilai pending dan progress berjalan queued 10 → ready 50 → done 100). Setelah selesai, ambil audio_url dari data.result.music[]. Jika gagal, data.error.message memberikan alasannya dan kuota yang dipotong di muka otomatis dikembalikan.

Response

code
integer
Kode status respons
data
array
Array data yang dikembalikan