Referensi API pembuatan musik (Fun-Music) - Alibaba Cloud Model Studio

Panduan pengguna: Untuk ikhtisar model dan panduan pemilihan, lihat Pembuatan musik.

Model ini saat ini dalam pratinjau terbatas. Ajukan akses di Model Gallery sebelum digunakan. Model ini hanya tersedia di Wilayah China (Beijing).

Prasyarat

Diperlukan Kunci API. Untuk mendapatkannya, lihat Dapatkan Kunci API.

Endpoint

POST https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation. Ganti WorkspaceId dengan workspace ID Anda yang sebenarnya. Protokol: HTTPS. Untuk keluaran streaming, atur header permintaan X-DashScope-SSE untuk mengaktifkan SSE (Server-Sent Events).

Model Studio telah merilis domain khusus ruang kerja untuk wilayah China (Beijing) dan Singapura. Domain khusus baru ini memberikan performa lebih unggul dan stabilitas lebih tinggi untuk permintaan inferensi. Kami menyarankan migrasi ke domain baru:

China (Beijing): dari https://dashscope.aliyuncs.com ke https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com
Singapura: dari https://dashscope-intl.aliyuncs.com ke https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com

{WorkspaceId} adalah workspace ID Anda, yang dapat ditemukan di halaman Workspace Details di Konsol Model Studio. Domain lama tetap berfungsi sepenuhnya.

Header permintaan

Parameter	Type	Wajib	Deskripsi
Authorization	string	Ya	`Bearer {api-key}`. Ganti `{api-key}` dengan Kunci API Anda.
Content-Type	string	Ya	`application/json`
X-DashScope-SSE	string	Tidak	Atur ke `enable` untuk mengaktifkan keluaran streaming SSE.

Body permintaan

modelstring(wajib)Nama model. Nilai yang diizinkan:

fun-music-v1
fun-music-preview

inputobject(wajib)Parameter input.

Properti

promptstring(wajib bersyarat)Sebuah prompt teks. Model secara otomatis menyusun dan menghasilkan musik berdasarkan prompt ini.

fun-music-v1: Salah satu dari lyrics atau prompt harus disediakan.
fun-music-preview: Wajib.

Batas karakter:

Non-streaming: 1–2.000 karakter
Streaming: 5–1.000 karakter Tionghoa atau kata bahasa Inggris

Jika prompt dan lyrics keduanya disediakan, hanya lyrics yang berlaku dan prompt diabaikan.

lyricsstring(wajib bersyarat)Lirik lagu yang dihasilkan.

fun-music-v1: Salah satu dari prompt atau lyrics harus disediakan.
fun-music-preview: Opsional.

Batas karakter:

Non-streaming: 5–350 karakter Tionghoa, 5–2.000 karakter bahasa Inggris
Streaming: 300–350 karakter Tionghoa, 200–250 kata bahasa Inggris

Jika lyrics dan prompt keduanya disediakan, hanya lyrics yang berlaku dan prompt diabaikan.

genderstring(opsional) Default: femaleJenis kelamin vokal. Hanya didukung oleh model fun-music-v1. Nilai yang valid:

male: Suara pria
female: Suara wanita

formatstring(opsional) Default: mp3Format encoding audio. Nilai yang valid:

mp3: Cocok untuk transfer jaringan dan penyimpanan
wav: Cocok untuk post-processing dan pemutaran berkualitas tinggi

enable_aigc_watermarkboolean(opsional) Default: falseSakelar watermark AIGC. Saat diaktifkan, sinyal audio kode Morse yang merepresentasikan "AI" (·— ··) ditambahkan di akhir audio yang dihasilkan untuk mengidentifikasi konten sebagai hasil buatan AI. Mengaktifkan watermark akan menambah durasi audio.

curl -X POST 'https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/api/v1/services/audio/music/generation' \
-H "Authorization: Bearer $DASHSCOPE_API_KEY" \
-H "Content-Type: application/json" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "Fresh summer folk song, acoustic guitar and harmonica accompaniment, upbeat tempo, suitable as background music for travel vlogs",
        "gender": "female"
    }
}'

Objek respons

request_id stringID permintaan, digunakan untuk troubleshooting dan pelacakan log.outputobjectOutput model.

Properti

audio objectOutput audio dari model.

Properti

data stringChunk audio yang di-encode Base64 dalam mode streaming. String kosong dalam mode non-streaming.url stringURL OSS file audio lengkap, berlaku selama 24 jam. Tersedia di semua respons non-streaming dan hanya pada pesan streaming akhir.id stringID file audio.expires_at integerTimestamp Unix yang menunjukkan kapan URL audio kedaluwarsa.

extra_info objectMetadata tambahan tentang audio yang dihasilkan.

Properti

channels integerJumlah saluran audio. Misalnya, 2 menunjukkan stereo.sample_rate stringLaju sampel audio. Misalnya, "48000".lyrics stringLirik lagu yang dihasilkan.

finish_reason stringStatus generasi:

null: Generasi sedang berlangsung
stop: Generasi selesai

usage objectInformasi penagihan untuk permintaan ini.

Properti

duration integerDurasi musik dalam detik, digunakan untuk penagihan.

{
    "output": {
        "audio": {
            "data": "",
            "expires_at": 1774936147,
            "id": "audio_46c51288-7ed6-95cc-a119-xxxxxxxxxxxx",
            "url": "http://dashscope-result-bj.oss-cn-beijing.aliyuncs.com/pre/fun-music/20260330/xxxxxxxx/a8db24cc-d35f-961b-af81-a9e8d8b01f67.mp3?xxx"
        },
        "extra_info": {
            "channels": 2,
            "lyrics": "[verse]\nMorning sunlight slips through the curtain,\nCoffee aroma fills up the room.\nOpen the book left unfinished yesterday,\nTime quietly drifts by this way.\n\n[chorus]\nTake it slow, there's no hurry,\nLife should be this carefree.\nToss your worries into the wind,\nEmbrace every sunny day and rainy season.",
            "sample_rate": "48000"
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "46c51288-7ed6-95cc-a119-xxxxxxxxxxxx"
}

​Prasyarat

​Endpoint

​Header permintaan

Body permintaan

Objek respons

Prasyarat

Endpoint

Header permintaan