Langsung ke konten utama
POST
Mereferensikan trek sumber: Operasi berbasis lagu yang sudah ada tidak memerlukan pencatatan id hulu apa pun, cukup kirim task_id (task_id kami dari tugas yang menghasilkan trek sumber) + audio_index (lagu ke berapa dalam music[] hasilnya, berbasis 1, default 1).
custom tidak wajib dan tidak disimpulkan untuk extend — hilangkan saja dan perpanjangan tetap berjalan normal; jika dikirim, akan diteruskan apa adanya ke pihak hulu. custom=true memperpanjang mengikuti lirik prompt; dengan custom=false atau tanpa custom, Anda dapat mengirim gpt_description (prompt inspirasi) untuk memandu arahnya.

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_id
string
wajib
task_id kami dari tugas yang menghasilkan trek sumber. Jika tidak ada atau sumber tidak dapat diselesaikan, 400 langsung dikembalikan saat pengiriman.
audio_index
integer
default:"1"
Lagu ke berapa dalam data.music[] dari hasil tugas sumber yang direferensikan (berbasis 1; default 1; sekali pembuatan biasanya menghasilkan 2 lagu: indeks 1 dan 2).
continue_at
integer
wajib
Mulai melanjutkan dari detik ke berapa.
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
Tidak perlu dikirim (tidak diwajibkan untuk extend). true=memperpanjang mengikuti lirik prompt; false=perpanjangan yang dipandu inspirasi.
prompt
string
Lirik untuk perpanjangan. Berlaku saat custom=true.
gpt_description
string
Prompt inspirasi. Berlaku saat custom=false atau saat custom tidak dikirim (memandu arah perpanjangan).
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.
vocal_gender
string
Jenis kelamin vokal: Male / Female. Berlaku di kedua mode.
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
Tingkat kreativitas, 0.001.00 (alias weirdness). Hanya berlaku saat custom=true.
audio_weight
number
Bobot audio, 0.001.00. Hanya berlaku saat custom=true.
auto_lyrics
boolean
true=menulis ulang lirik yang diberikan secara kreatif. Hanya berlaku saat custom=true.
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 adalah pending dan progress berjalan: antre 10 → siap 50 → selesai 100). Setelah selesai, ambil audio_url yang sudah diperpanjang 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