Flow Music
Membuat Musik
Flow Music menghasilkan musik dari teks. Mendukung prompt gaya / lirik / BPM / kontrol durasi, setiap permintaan menghasilkan satu lagu
POST
Autentikasi
Semua endpoint memerlukan autentikasi menggunakan Bearer TokenMendapatkan API Key:Kunjungi halaman pengelolaan API Key untuk mendapatkan API Key AndaTambahkan ke header permintaan saat digunakan:
Parameter Permintaan
Nama model, selalu isi
"flowmusic" (tidak peka huruf besar/kecil)Prompt deskripsi gaya musik atau suaraContoh:
"upbeat pop music with piano"sound_prompt dan lyrics tidak boleh kosong keduanya (isi minimal salah satu). Setiap permintaan hanya menghasilkan satu lagu.Teks lirik, dapat diperoleh terlebih dahulu melalui endpoint Membuat Lirik lalu diisikan kembaliContoh:
"[Verse 1]\nSekelam apa pun malam, fajar kan tiba\n..."Judul musik yang dihasilkan
BPM (ketukan per menit), harus ≥ 1Contoh:
"120"Durasi hasil (detik)Rentang yang didukung:
1 ~ 240 detikSeed acak, digunakan untuk mereproduksi hasil
Mengirim nilai seed yang sama pada permintaan yang sama akan menghasilkan hasil yang serupa, tetapi tidak dijamin sepenuhnya identik.
Respons
Kode status respons, bernilai 200 jika berhasil
Array data yang dikembalikan
Skenario Penggunaan
Skenario 1: Membuat musik hanya dengan prompt gaya
Skenario 2: Lirik + gaya menjadi lagu
Memeriksa hasil tugasPembuatan musik adalah tugas asinkron; setelah diajukan,
task_id akan dikembalikan. Gunakan endpoint Mendapatkan Status Tugas untuk memeriksa progres dan hasil pembuatan.Contoh Hasil Tugas Selesai
Contoh respons kueri (GET /v1/music/tasks/{task_id}):