API sertifikat lisensi komersial musik

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Endpoint sertifikat lisensi komersial musik dipakai untuk mendaftar lagu yang boleh dilisensikan oleh pengguna API Key saat ini, membuat sertifikat PDF, menanyakan riwayat sertifikat, dan mengunduh berkas yang sudah diterbitkan.

Semua endpoint memakai New API Key secara seragam:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Alamat dasar:

https://www.suno-api.io

Prasyarat

• API Key harus sah dan dimiliki oleh pengguna yang membutuhkan sertifikat.
• Pengguna harus lebih dulu menyelesaikan penautan identitas lisensi (lihat "0. Kelayakan dan identitas lisensi"); setelah dikonfirmasi, identitas terkunci sesuai aturan produk.
• Pengguna harus memenuhi syarat isi ulang kumulatif untuk perorangan atau perusahaan.
• Endpoint umum hanya mengembalikan informasi identitas yang disamarkan; tidak pernah mengembalikan nomor identitas, nomor telepon, atau kode kredit sosial terpadu dalam bentuk teks biasa.
• Setiap lagu hanya bisa menerbitkan satu sertifikat yang berhasil; sertifikat yang gagal dibuat tidak memakai kelayakan lagu tersebut.
• Saat ini didukung jenis pembuatan tertentu yang sudah selesai, memiliki audio, dan memiliki Suno Song ID asli. Bisa dipilih atau tidaknya lagu ditentukan oleh authorization.selectable di daftar lagu.

0. Kelayakan dan identitas lisensi

Sebelum menerbitkan sertifikat, kelayakan perlu ditanyakan dan identitas perlu ditautkan. Kedua endpoint ini gratis.

0.1 Menanyakan kelayakan dan identitas

Endpoint: GET /api/music/authorization/context

{
  "code": 200,
  "message": "success",
  "data": {
    "identity": {
      "exists": false
    },
    "eligibility": {
      "current_amount": 216.3,
      "personal_required_amount": 200,
      "company_required_amount": 500,
      "personal_eligible": true,
      "company_eligible": false
    },
    "stats": {
      "authorized_song_count": 0,
      "certificate_count": 0
    }
  }
}

0.2 Menautkan identitas lisensi

Endpoint: POST /api/music/authorization/identity

{
  "identity_type": "personal",
  "legal_name": "Budi Santoso",
  "id_number": "110101199001010000",
  "contact_name": "Budi Santoso",
  "phone": "13800000000",
  "email": "user@example.com",
  "address": "Jl. Merdeka 12, Jakarta",
  "confirm_locked": true
}

Respons mengembalikan informasi identitas yang disamarkan: {"identity": {...}}. Setelah penautan berhasil, pastikan lewat endpoint context bahwa identity.exists sudah menjadi true, lalu panggil daftar lagu dan endpoint penerbitan. Bila informasi identitas perlu diubah, hubungi layanan pelanggan.

1. Mendaftar lagu yang bisa dilisensikan

Endpoint: GET /api/music/authorization/songs

Parameter kueri

Contoh permintaan

curl "https://www.suno-api.io/api/music/authorization/songs?p=1&page_size=20&status=selectable" \
  -H "Authorization: Bearer YOUR_API_KEY"

Contoh respons

{
  "success": true,
  "message": "",
  "data": {
    "page": 1,
    "page_size": 20,
    "total": 1,
    "items": [
      {
        "task_id": 10001,
        "suno_song_id": "suno-song-id-1",
        "title": "Lagu contoh",
        "generation_type": "generate",
        "completed_at": 1784000000,
        "created_at": 1783999000,
        "audio_url": "https://example.com/audio.mp3",
        "model_name": "suno-v6",
        "authorization": {
          "selectable": true
        }
      }
    ]
  }
}

Bila authorization.selectable=false, respons menjelaskan alasannya lewat reason_code dan reason. Lagu yang sertifikatnya sudah diterbitkan juga mengembalikan certificate_id dan certificate_no.

2. Membuat sertifikat

Endpoint: POST /api/music/authorization/certificates

Parameter body

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/authorization/certificates \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "song_ids": ["suno-song-id-1", "suno-song-id-2"],
    "confirm_risk_terms": true
  }'

Contoh respons

{
  "success": true,
  "message": "",
  "data": {
    "certificate": {
      "id": 101,
      "certificate_no": "CERTIFICATE-NO",
      "verification_code": "VERIFY-CODE",
      "status": "issued",
      "song_count": 2,
      "identity_type_snapshot": "personal",
      "licensee_name_masked": "B*",
      "document_no_masked_snapshot": "11**************34",
      "phone_masked_snapshot": "138****0000",
      "pdf_sha256": "PDF_SHA256",
      "issued_at": 1784000100,
      "created_at": 1784000000,
      "updated_at": 1784000100,
      "download_url": "/api/music/authorization/certificates/101/download",
      "songs": []
    }
  }
}

Pada respons yang berhasil, status bernilai issued. Bila rendering PDF gagal, sertifikat ditandai failed dan lagu terkait masih bisa dikirim ulang setelah masalahnya diperbaiki.

3. Menanyakan riwayat sertifikat

Endpoint: GET /api/music/authorization/certificates

Parameter kueri

Contoh permintaan

curl "https://www.suno-api.io/api/music/authorization/certificates?p=1&page_size=20" \
  -H "Authorization: Bearer YOUR_API_KEY"

Struktur respons

data pada respons adalah objek berhalaman yang memuat page, page_size, total, dan items. Setiap item di items adalah ringkasan sertifikat dan menyertakan cuplikan lagu sertifikat tersebut.

4. Menanyakan detail sertifikat

Endpoint: GET /api/music/authorization/certificates/:id

Parameter jalur id adalah ID angka sertifikat. Endpoint ini hanya mengizinkan akses ke sertifikat milik pengguna API Key saat ini.

Contoh permintaan

curl https://www.suno-api.io/api/music/authorization/certificates/101 \
  -H "Authorization: Bearer YOUR_API_KEY"

Struktur respons

Saat berhasil mengembalikan data.certificate, dengan kolom berupa nomor sertifikat, status, informasi pemegang lisensi yang disamarkan, waktu penerbitan, nilai verifikasi PDF, alamat unduhan, dan cuplikan lagu yang dilisensikan.

5. Mengunduh PDF sertifikat

Endpoint: GET /api/music/authorization/certificates/:id/download

Hanya sertifikat dengan status issued yang bisa diunduh. Permintaan unduhan tetap memerlukan API Key yang sah, dan Anda hanya bisa mengunduh sertifikat milik sendiri.

Contoh permintaan

curl https://www.suno-api.io/api/music/authorization/certificates/101/download \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --output authorization-certificate.pdf

Respons yang berhasil adalah aliran berkas application/pdf; nama berkas mengikuti Content-Disposition dari backend.

Penyebab kegagalan umum

Catatan

• Gunakan suno_song_id yang dikembalikan daftar lagu; jangan pakai ID pengganti pending:* atau ID dari tabel tugas.
• Alamat unduhan bukan tautan publik; jangan menghapus autentikasi API Key.
• Catatan sertifikat milik pengguna yang sesuai dengan API Key dan tidak bisa ditanyakan atau diunduh antar pengguna.
• Cakupan lisensi, ketentuan pembatasan, dan isi PDF akhir mengikuti sertifikat yang benar-benar diterbitkan.