Gunakan Suno Sounds melalui Rivya Public API v1 dengan id model suno-sounds, input yang didukung, parameter, aturan Files API, kredit, dan contoh response.

Tersedia via APIInput teks siapAudio

ID model API

suno-sounds

Input

text

Files API

Tidak diperlukan untuk request minimal

Kredit dasar

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-sounds	Gunakan suno-sounds 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	V5	-	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.
soundLoop	select	Tidak	false	-	false, true	Pemutaran loop
soundTempo	number	Tidak	-	min 1 / max 300 / step 1	-	Mengatur tempo dalam ketukan per menit. Nilai yang lebih tinggi biasanya terasa lebih cepat dan lebih berguna untuk desain suara ritmis.
soundKey	select	Tidak	Any	-	Any, Cm, C#m, Dm, D#m, Em, Fm, F#m, Gm, G#m, Am, A#m, Bm, C, C#, D, D#, E, F, F#, G, G#, A, A#, B	Mengatur nada dasar musik. Tentukan hanya ketika hasil perlu cocok dengan harmoni atau melodi yang sudah ada; jika tidak, membiarkannya luas biasanya lebih aman.

Request minimal

{
  "model": "suno-sounds",
  "prompt": "A polished audio concept for a short product story",
  "params": {
    "model": "V5",
    "soundLoop": "false",
    "soundTempo": 1,
    "soundKey": "Any"
  }
}

Response create

Endpoint create mengembalikan public task id. Poll endpoint status sampai tugas berhasil atau gagal.

{
  "id": "task_suno_sounds_example",
  "status": "queued",
  "model": "suno-sounds",
  "reserved_credits": 3,
  "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