Suno API: status resmi, kunci API, dan contoh Python

Per 17 Oktober 2026, Suno punya API resmi, tetapi Anda tidak bisa mendaftar: platform.suno.com hanya menampilkan halaman masuk untuk pemilik akun API yang sudah ada, tanpa dokumentasi publik, harga, atau akses mandiri, dan Suno menyebut pada Juli bahwa mereka mulai dengan sekelompok mitra pilihan. Tanpa undangan, dua opsi lain bisa dipakai hari ini.

Apakah Suno punya API resmi?

Suno memasarkan API di platform.suno.com, dan satu halaman itu adalah seluruh wajah publiknya.

Judulnya menjanjikan “original songs, covers, and mashups from a single prompt” di balik “a simple REST API”, dan satu-satunya tindakan di halaman adalah masuk dengan akun Google yang tertaut ke akun Suno Anda atau dengan kode yang dikirim lewat email. Tautan lainnya adalah suno.com, Terms, dan Privacy, tidak ada lagi; /docs dan /pricing di domain yang sama menampilkan halaman masuk yang sama (diperiksa 17 Oktober 2026). Jadi API-nya ada, tetapi dokumentasi dan harganya baru terlihat setelah masuk.

Ajakan bermitra diketahui dari Music Business Worldwide, yang pada 2 Juli 2026 melaporkan bahwa kepala produk Suno, Jack Brody, mengumumkan rencana itu dalam unggahan LinkedIn pada 1 Juli dan menyertakan tautan formulir pendaftaran. Formulir itu, seperti dikutip laporan tersebut, berbunyi: “We're beginning to explore a developer API, starting with a curated group of partners.” Artinya, Suno mulai menjajaki API pengembang bersama sekelompok mitra pilihan. Tanggal peluncuran tidak diumumkan, dan tidak ada tambahan tanggal di halaman platform, catatan rilis, maupun pusat bantuan Suno.

Pembeli perusahaan diarahkan ke tim penjualan: Ketentuan Suno menyebut “if you are an enterprise user, you must contact sales to use our Service”. Laporan yang sama mencatat bahwa Suno “has not released self-serve developer access or published its own API documentation”, dan itu sesuai dengan yang masih tampil di halaman pada Oktober.

Tiga cara memanggil Suno dari kode hari ini

Akses mitra resmi. Formulir yang ditautkan Brody pada Juli adalah satu-satunya pintu yang ditunjukkan Suno, dan laporan itu menyebut akses awal untuk sekelompok mitra pilihan, bukan pendaftaran terbuka. Pada 17 Oktober 2026 halaman platform hanya memuat kotak masuk, tanpa formulir, daftar tunggu, atau tautan permintaan akses, dan kami tidak menemukan tautan publik ke formulir itu di halaman Suno sendiri. Music Business Worldwide tidak melaporkan jadwal peluncuran yang lebih luas.

Pembungkus GitHub tidak resmi. gcui-art/suno-api adalah jalan pintas paling dikenal: 3.259 bintang dan sekitar 100 issue terbuka pada 17 Oktober 2026, dengan commit terakhir pada 6 Maret 2026. README-nya menyebut API resmi “is not yet available” dan meminta tiga hal: cookie akun Suno Anda sendiri, disalin manual dari tab jaringan di browser; kunci 2Captcha berbayar, karena Suno terus menyajikan tantangan hCaptcha; dan browser sungguhan yang dijalankan lewat Playwright dengan patch rebrowser. Issue #262, dibuka pada 14 Desember 2025, menyebut penulisnya “lacks the time to maintain it”.

Ketentuan Layanan Suno, terakhir direvisi 10 Agustus 2026 dan berlaku 3 September 2026, melarang “any data mining, robots, scraping, or similar data gathering or extraction methods” dan juga melarang memperoleh konten “through any means not intentionally made available or provided for through the Service”. Baca kedua klausul itu di Ketentuan Suno sebelum membangun produk di atas pembungkus yang menjalankan suno.com dengan cookie Anda. README-nya sendiri tidak memuat peringatan soal itu; satu-satunya baris hukumnya adalah lisensi LGPL-3.0.

Platform API pihak ketiga. OmniaKey adalah platform API pihak ketiga, bukan Suno. OmniaKey menjual akses API ke Suno v4.5 dan Suno v6 melalui API media asinkron miliknya sendiri, dengan kunci yang diterbitkan dan ditagih OmniaKey. Dokumentasinya mencantumkan tepat dua ID model, suno-v4.5 dan suno-v6, dan setiap permintaan mengembalikan satu lagu jadi yang sudah dimix, sedangkan akun Suno menampilkan dua alternatif. Opsi inilah yang kami jalankan dari awal sampai akhir di bawah.

Membuat lagu dengan Python

Satu permintaan membuat tugas, panggilan kedua memeriksa statusnya, dan MP3 jadi datang sebagai tautan bertanda tangan. Ekspor kuncinya, simpan skrip sebagai suno_song.py, lalu jalankan; skrip memeriksa status setiap 5 detik karena progress.percent hanya perkiraan dan bisa tetap 0 selama tugas berjalan.

export OMNIAKEY_API_KEY="your-key"
python3 suno_song.py

import os
import time
import uuid

import requests

API = "https://api.omniakey.com/v1/media/tasks"
HEADERS = {"Authorization": f"Bearer {os.environ['OMNIAKEY_API_KEY']}"}

# 1. Create the job. Reuse the same Idempotency-Key only when retrying this exact request.
job = requests.post(
    API,
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "model": "suno-v4.5",
        "type": "audio",
        "operation": "generate",
        "input": {"prompt": "calm lo-fi beat for late-night coding, soft piano, vinyl crackle"},
        "parameters": {"title": "Late Build", "instrumental": True},
    },
    timeout=30,
)
job.raise_for_status()
task = job.json()
print("task:", task["id"], task["status"])

# 2. Poll on status, not on progress.percent, until the job finishes.
while task["status"] in ("queued", "processing"):
    time.sleep(5)
    task = requests.get(f"{API}/{task['id']}", headers=HEADERS, timeout=30).json()

if task["status"] != "succeeded":
    raise SystemExit(f"job ended {task['status']}: {task.get('error')}")

# 3. Download the MP3 now: the signed URL expires in about an hour.
asset = task["assets"][0]
with open("late-build.mp3", "wb") as f:
    f.write(requests.get(asset["url"], timeout=120).content)
print("saved late-build.mp3", asset["byte_size"], "bytes")

Kami menjalankan skrip yang sama pada 17 Oktober 2026 dan hasilnya dua baris:

task: task_VDvzdpfABcqDOIpo9I1p7CXHg99elSuK queued
saved late-build.mp3 3506516 bytes

Dari mulai sampai berkas tersimpan butuh 82 detik. Berkasnya MP3 stereo 48 kHz, sekitar 161 kbps, durasi 2:55, ukuran 3,5 MB, dan instrumental karena skrip menyetel instrumental ke true.

Untuk membandingkan kedua model di kedua mode masukan, kami juga membuat empat lagu lewat API OmniaKey pada 17 Oktober 2026, mulai 13:03 UTC, dengan pemeriksaan status setiap 4 detik.

Keempatnya selesai pada percobaan pertama, dan setiap permintaan mengembalikan satu MP3. Deskripsi menghasilkan lagu utuh sekitar tiga menit; gaya yang sama dengan delapan baris lirik buatan kami kembali dalam 45–63 detik, jadi perkirakan trek pendek saat Anda menulis lirik sendiri. Bitrate berkisar 151 sampai 195 kbps pada stereo 48 kHz, dan tautan unduhan bertanda tangan kedaluwarsa sekitar satu jam setelah setiap tugas dibuat.

Parameter dan batasan

• input.lyrics yang tidak kosong beralih ke mode lirik sendiri, dan di mode itu input.prompt, parameters.style, atau parameters.tags menjelaskan gayanya; tugas tanpa prompt dan tanpa lirik ditolak.
• suno-v6 dipilih lewat ID model dan tidak perlu mv, sedangkan mv hanya berlaku untuk v4.5.
• Hanya generate yang dilayani. Perpanjangan, lirik terpisah, dan sintesis suara gagal dengan 503 no_available_channel, dan biaya awal dikembalikan.
• Satu permintaan adalah satu lagu jadi, jadi parameters.n harus 1.
• Tautan berkas ditandatangani dan berumur pendek, sekitar satu jam, dan catatan tugas disimpan 24 jam setelah dibuat.

Error dan pengembalian dana

Tugas yang gagal, dibatalkan, atau tidak pernah sampai ke penyedia dikembalikan otomatis, sedangkan tugas yang dibatalkan tetapi tetap selesai ditagih sesuai status akhirnya. Mengirim ulang kunci idempotensi yang sama dengan isi yang sama mengembalikan tugas asli dengan kode 200, bukan membuat tugas kedua, sehingga percobaan ulang setelah timeout hanya ditagih sekali. Pemulihannya singkat: jika pembuatan timeout, kirim ulang isi dan kunci yang identik; setelah memegang ID tugas, terus pantau tugas itu.

Pertanyaan umum

Apakah ada Suno API gratis?

Suno tidak menerbitkan tingkatan API gratis di platform.suno.com. Paket gratis ada di aplikasi suno.com: v6-mini terbuka untuk semua orang, dan varian v4.5-all gratis sejak 21 Oktober 2025. Hasil dari tingkatan gratis hanya untuk penggunaan pribadi dan nonkomersial.

Bisakah lagu dari Suno API dipakai secara komersial?

Ketentuan Suno mengalihkan Output kepada pelanggan Pro dan Premier, dan mengizinkan penggunaan komersial hanya untuk Output “downloaded by you through an approved channel”, yaitu yang Anda unduh lewat kanal yang disetujui. Output dari tingkatan gratis tetap nonkomersial, dan remix hanya untuk penggunaan pribadi apa pun paketnya. Lagu dari API pihak ketiga tidak terkecuali, jadi baca Ketentuan Suno sebelum menaruh lagu hasil generate di produk berbayar.

Berapa lama satu lagu dibuat?

Dokumentasi audio menyebut dua puluh detik sampai dua menit untuk satu pembuatan. Empat tugas kami memakan 70 sampai 105 detik, dan menjalankan skrip memakan 82 detik dari mulai sampai berkas tersimpan.

Sebaiknya pakai v4.5 atau v6?

Suno mengumumkan keluarga v6 pada 9 September 2026 dan v4.5 pada 1 Mei 2025. v6 dipilih hanya lewat ID model, sedangkan v4.5 menerima parameters.mv untuk mengunci versi, dan ID suno-v4.5 milik OmniaKey tidak menyebut varian v4.5 mana yang dipetakan. Suno menyebut v6 sebagai model unggulannya, jadi mulailah dengan Suno v6 kecuali Anda perlu mengunci versi v4.5 yang lama.

Bagaimana cara mendapatkan kunci Suno API?

Jika akun API sudah ada, masuk ke platform.suno.com dengan akun Google yang tertaut ke akun Suno Anda atau dengan kode lewat email. Tanpa akun, formulir mitra Juli adalah satu-satunya pintu publik, dan hari ini tidak ada di halaman itu. Platform pihak ketiga seperti OmniaKey menerbitkan kuncinya sendiri, terpisah dari login Suno mana pun.