Docs / audio / Suno V5

Suno V5 online

Generate lagu penuh dengan vokal dan instrumen dari satu prompt. Sekali generate menghasilkan 2 versi lagu untuk dipilih.

Rp Rp970 / generate (2 lagu) Rp1.080 −10.2% ⏱ ±60–180 detik perkiraan waktu suno/v5 model id Musik dengan vokal2 versi per generateLirik kustomInstrumental

1 · Create a task

Kirim permintaan untuk membuat tugas generasi audio. Wajib header Idempotency-Key. Saldo direservasi Rp970; task gagal tidak ditagih.

POSThttps://run.getcore.id/v1/tasks

curl -X POST https://run.getcore.id/v1/tasks \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Idempotency-Key: my-task-001" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno/v5",
    "input": {
      "prompt": "lo-fi hip hop santai untuk belajar, rhodes piano hangat, drum berdebu",
      "instrumental": true
    }
  }'

const res = await fetch('https://run.getcore.id/v1/tasks', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Idempotency-Key': 'my-task-001',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    "model": "suno/v5",
    "input": {
      "prompt": "lo-fi hip hop santai untuk belajar, rhodes piano hangat, drum berdebu",
      "instrumental": true
    }
  }),
});
const task = await res.json();

import requests

res = requests.post(
    "https://run.getcore.id/v1/tasks",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Idempotency-Key": "my-task-001",
    },
    json={
      "model": "suno/v5",
      "input": {
        "prompt": "lo-fi hip hop santai untuk belajar, rhodes piano hangat, drum berdebu",
        "instrumental": true
      }
    },
)
task = res.json()

Input parameters

Name	Type	Required	Description	Example
`style`	string	No	Genre dan nuansa, mis. "lo-fi hip hop, rhodes piano, santai". Mode kustom. (max 1000 chars)	—
`title`	string	No	Judul lagu. Mode kustom. (max 80 chars)	—
`prompt`	string	Yes	Mode biasa: deskripsi gaya lagu (maks 500 karakter). Mode kustom: lirik persis yang dinyanyikan. (max 5000 chars)	`lo-fi hip hop santai untuk belajar, rhodes pia`
`customMode`	boolean	No	Aktifkan untuk menulis lirik sendiri. Style dan Title jadi wajib diisi.	`false`
`vocalGender`	string	No	Preferensi vokal laki-laki (m) atau perempuan (f). Tidak dijamin. Opsi: `m` `f`	—
`instrumental`	boolean	No	Hasilkan musik tanpa vokal.	`true`
`negativeTags`	string	No	Genre atau elemen yang dihindari, mis. "heavy metal, distorsi". (max 200 chars)	—

2 · Poll the result

Ambil status tugas hingga selesai — poll tiap 2–5 detik.

GEThttps://run.getcore.id/v1/tasks/{task_id}

Respons saat sukses:

{
  "id": "task_9f2c…",
  "status": "succeeded",
  "model": "suno/v5",
  "price": {
    "currency": "IDR",
    "estimated": 970,
    "reserved": 970,
    "final": 970
  },
  "output": {
    "urls": [
      "https://storage.getcore.id/outputs/task_9f2c…/0.mpeg"
    ],
    "expires_at": "(7 hari setelah selesai)"
  }
}

Status values

Status	Keterangan
`queued`	Tugas sedang diantrikan.
`processing`	Sedang diproses.
`succeeded`	Berhasil.
`failed`	Gagal — lihat error detail, tidak ditagih.

Output bertipe audio/mpeg, dilayani dari CDN kami dan berlaku 7 hari — salin ke penyimpananmu sendiri untuk jangka panjang.

Best practices

Bila generation gagal, task berstatus failed dengan error.code ternormalisasi (mis. moderation_blocked, upstream_error) dan price.final = 0 — saldo dikembalikan otomatis. Daftar lengkap kode error ada di Error handling. Selalu kirim Idempotency-Key unik per tugas agar retry aman.

Coba tanpa kode: jalankan model ini langsung dari Playground atau lihat di API Market.