Referensi API model Fun-Music - Alibaba Cloud Model Studio

Parameter API untuk model pembuatan musik Fun-Music.

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

Penting

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).

Penting

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

Non-streaming

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"
    }
}'

Streaming

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" \
-H "X-DashScope-SSE: enable" \
-d '{
    "model": "fun-music-v1",
    "input": {
        "prompt": "High-energy electronic dance music, synthesizer effects, full of energy, suitable for workout scenes",
        "gender": "male"
    }
}'

model string (wajib)

Nama model. Nilai yang diizinkan:

fun-music-v1
fun-music-preview

input object (wajib)

Parameter input.

Properti

prompt string (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

Catatan

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

lyrics string (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

Catatan

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

gender string (opsional) Default: female

Jenis kelamin vokal. Hanya didukung oleh model fun-music-v1. Nilai yang valid:

male: Suara pria
female: Suara wanita

format string (opsional) Default: mp3

Format encoding audio. Nilai yang valid:

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

enable_aigc_watermark boolean (opsional) Default: false

Sakelar 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.

Objek respons

Non-streaming

{
    "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"
}

Streaming (pesan antara)

{
    "output": {
        "audio": {
            "data": "Base64-encoded audio data",
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
        },
        "finish_reason": "null"
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}

Streaming (pesan akhir)

{
    "output": {
        "audio": {
            "expires_at": 1774937185,
            "id": "audio_a8db24cc-d35f-961b-af81-xxxxxxxxxxxx",
            "data": "",
            "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,
            "sample_rate": "48000",
            "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."
        },
        "finish_reason": "stop"
    },
    "usage": {
        "duration": 200
    },
    "request_id": "a8db24cc-d35f-961b-af81-xxxxxxxxxxxx"
}

request_id string

ID permintaan, digunakan untuk troubleshooting dan pelacakan log.

output object

Output model.

Properti

audio object

Output audio dari model.

Properti

data string

Chunk audio yang di-encode Base64 dalam mode streaming. String kosong dalam mode non-streaming.

url string

URL OSS file audio lengkap, berlaku selama 24 jam. Tersedia di semua respons non-streaming dan hanya pada pesan streaming akhir.

id string

ID file audio.

expires_at integer

Timestamp Unix yang menunjukkan kapan URL audio kedaluwarsa.

extra_info object

Metadata tambahan tentang audio yang dihasilkan.

Properti

channels integer

Jumlah saluran audio. Misalnya, 2 menunjukkan stereo.

sample_rate string

Laju sampel audio. Misalnya, "48000".

lyrics string

Lirik lagu yang dihasilkan.

finish_reason string

Status generasi:

null: Generasi sedang berlangsung
stop: Generasi selesai

usage object

Informasi penagihan untuk permintaan ini.

Properti

duration integer

Durasi musik dalam detik, digunakan untuk penagihan.