Docs Rivya AI
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.

KeyTipeWajibDefaultDeskripsi
modelstringYasuno-musicGunakan suno-music sebagai id model API.
promptstringYa-Maksimum 500 karakter untuk model ini.
paramsobjectTidak-Objek parameter khusus model. Gunakan baris di bawah untuk key yang diizinkan.
client_request_idstringTidak-ID sisi klien opsional untuk melacak request di sistem Anda.

Parameter model

KeyTipeWajibDefaultRentangOpsiDeskripsi
modelselectTidakV4_5-V4, V4_5, V4_5PLUS, V4_5ALL, V5, V5_5Memilih keluarga generasi Suno yang digunakan. Versi yang lebih baru sering menangani gaya dan detail dengan lebih baik, tetapi dapat berbeda dalam biaya dan perilaku.
instrumentalselectTidakfalse-false, trueTanpa 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.