Autentikasi

Diperbarui 2026-09-18 · tim Suno-API

Semua permintaan ke Suno-API diautentikasi dengan kunci API. Halaman ini menjelaskan cara membuat kunci, cara mengirimnya, arti setiap kesalahan, dan cara menjaga kunci tetap aman.

Apa itu kunci API

Kunci adalah bearer token yang terikat pada akun Anda. Kunci membawa saldo, jadi siapa pun yang memegangnya bisa membelanjakannya. Kunci hanya ditampilkan sekali saat dibuat: salin dan simpan di tempat yang aman.

Membuat kunci

1. Daftar di https://www.suno-api.io — cukup e-mail, tanpa nomor telepon.
2. Buka pengelolaan token di konsol.
3. Buat kunci baru lalu salin.

Kunci berformat sk-…. Kunci yang hilang tidak bisa dipulihkan: buat yang baru dan hapus yang lama.

Menggunakan kunci

Format header

Kirim kunci di header Authorization pada setiap permintaan:

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

Contoh

curl -X POST https://www.suno-api.io/api/music/create \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"description": "musik piano tenang untuk kafe"}'

Kesalahan autentikasi

401 Unauthorized

Header tidak ada, formatnya salah, atau kunci tidak ditemukan.

{
  "error": {
    "message": "Invalid API key provided",
    "type": "invalid_request_error",
    "code": "invalid_api_key"
  }
}

Pastikan header persis Bearer <kunci> (ada spasi setelah Bearer) dan tidak ada karakter baris baru di akhir kunci.

403 Forbidden

Kunci ada tetapi tidak berhak atas permintaan ini — paling sering karena kunci dinonaktifkan atau akun ditangguhkan. Periksa status akun di konsol dan hubungi dukungan bila penyebabnya tidak jelas.

Praktik terbaik keamanan

Jangan pernah menaruh kunci di kode klien

Jangan menyematkan kunci di halaman web, aplikasi seluler, atau program desktop. Siapa pun yang membuka inspektur peramban bisa membacanya dan membelanjakan saldo Anda. Panggil API dari server Anda sendiri dan sediakan endpoint Anda sendiri untuk pengguna.

Gunakan variabel lingkungan

Linux / macOS

# ~/.bashrc atau ~/.zshrc
export SUNO_API_KEY="sk-your-key-here"

# Python
import os
api_key = os.environ["SUNO_API_KEY"]

.env

# berkas .env — masukkan ke .gitignore
SUNO_API_KEY=sk-your-key-here

Windows

setx SUNO_API_KEY "sk-your-key-here"

Node.js

require('dotenv').config();
const apiKey = process.env.SUNO_API_KEY;

Rotasi kunci bila perlu

Rotasi kunci setiap 3-6 bulan, dan segera bila mencurigai kebocoran. Hapus kunci yang tidak lagi dipakai: kunci menganggur hanyalah risiko menganggur.

Batas permintaan

Permintaan dibatasi per kunci:

429 Too Many Requests

Saat melewati batas, API membalas 429 dan responsnya bisa memuat nilai retry_after dalam detik. Tunggu selama itu sebelum mencoba lagi; turunkan laju permintaan, antrekan pekerjaan, atau ulangi dengan backoff eksponensial alih-alih dalam loop ketat.

Kebijakan percobaan ulang

Coba ulang hanya pada kegagalan yang jelas. Jangan coba ulang setelah timeout baca atau koneksi: endpoint pembuatan bersifat sinkron, jadi timeout bisa berarti pesanan sudah diterima dan sedang dibuat — mencoba ulang membuat pesanan ganda dan menagih dua kali. Setel timeout klien 300 detik atau lebih dan, setelah koneksi terputus, periksa pesanan dengan GET /api/music/songs sebelum mengirim ulang. Lihat "Waktu tunggu dan pengaturan timeout" di Ringkasan API baru.

Kirim ulang dengan backoff eksponensial alih-alih perulangan rapat:

import time

delay = 1.0
for attempt in range(5):
    response = call_api()
    if response.status_code != 429:
        break
    time.sleep(delay)
    delay *= 2

Pertanyaan umum

Bagaimana format kuncinya?

Diawali sk- lalu diikuti huruf dan angka, totalnya sekitar 50-60 karakter.

Bisa memanggil API langsung dari peramban?

Secara teknis bisa, tetapi jangan di produksi: kunci akan terlihat oleh semua pengunjung. Proksikan melalui backend Anda.

Bagaimana tahu kunci masih berlaku?

Kirim permintaan terautentikasi apa pun. 200 berarti masih berfungsi; 401 berarti kunci tidak valid atau sudah dihapus.

Kunci saya hilang. Bagaimana?

Kunci tidak bisa dipulihkan. Buat yang baru di konsol lalu hapus yang lama.

Berapa banyak kunci per akun?

Tidak ada batas tetap. Gunakan satu kunci per aplikasi atau lingkungan agar bisa dicabut terpisah, dan hapus yang tidak lagi dipakai.

Apakah kunci kedaluwarsa?

Berlaku sampai Anda menghapusnya atau menutup akun. Rotasi berkala adalah praktik yang baik.

Bagaimana memantau pemakaian?

Masuk ke konsol: di sana terdaftar pemakaian per kunci, termasuk jumlah permintaan, pengeluaran, dan tugas terbaru.

Halaman terkait

• Panduan cepat
• Model yang didukung