Halaman API Model
Integrasi API Suno Music
Gunakan Suno Music melalui Rivya Public API v1 dengan id model suno-music, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.
Tersedia via APIInput teks siapAudio
ID model API
suno-music
Input
text
Files API
Tidak diperlukan untuk request minimal
Kredit dasar
12
Kapabilitas
Audio
Tagihan
FIXED
Batas prompt
500 karakter
Kontrak request
Kirim id model di level atas. Kontrol khusus model berada di params.
| Key | Tipe | Wajib | Default | Deskripsi |
|---|---|---|---|---|
| model | string | Ya | suno-music | Gunakan suno-music sebagai id model API. |
| prompt | string | Ya | - | Maksimum 500 karakter untuk model ini. |
| params | object | Tidak | - | Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan. |
| client_request_id | string | Tidak | - | ID sisi klien opsional untuk melacak request di sistem Anda. |
Parameter model
| Key | Tipe | Wajib | Default | Rentang | Opsi | Deskripsi |
|---|---|---|---|---|---|---|
| model | select | Tidak | V4_5 | - | V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5 | Memilih keluarga generasi Suno yang digunakan. Versi yang lebih baru sering menangani gaya dan detail dengan lebih baik, tetapi dapat berbeda dalam biaya dan perilaku. |
| instrumental | select | Tidak | false | - | false, true | Tanpa vokal |
Request minimal
{
"model": "suno-music",
"prompt": "A polished audio concept for a short product story",
"params": {
"model": "V4_5",
"instrumental": "false"
}
}Response create
Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.
{
"id": "task_suno_music_example",
"status": "queued",
"model": "suno-music",
"reserved_credits": 12,
"final_credits": 0,
"created_at": "2026-05-11T00:00:00.000Z",
"updated_at": "2026-05-11T00:00:00.000Z",
"result": null,
"error": null
}Error umum
validation_failed, insufficient_credits, idempotency_conflict, rate_limited, not_found
Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.