Pengesahan

Dikemas kini 2026-09-18 · pasukan Suno-API

Semua permintaan ke Suno-API disahkan dengan kunci API. Halaman ini menerangkan cara mencipta kunci, cara menghantarnya, maksud setiap ralat dan cara menyimpan kunci dengan selamat.

Apa itu kunci API

Kunci ialah token bearer yang terikat pada akaun anda. Ia membawa baki, jadi sesiapa yang memegang kunci boleh membelanjakan baki itu. Kunci hanya dipaparkan sekali semasa dicipta: salin dan simpan di tempat selamat.

Mencipta kunci

1. Daftar di https://www.suno-api.io — hanya e-mel, bukan nombor telefon.
2. Buka pengurusan token dalam konsol.
3. Cipta kunci baharu dan salin.

Kunci berformat sk-…. Kunci yang hilang tidak boleh dipulihkan: cipta yang baharu dan hapuskan yang lama.

Menggunakan kunci

Format pengepala

Hantar kunci dalam pengepala 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": "muzik piano tenang untuk kafe"}'

Ralat pengesahan

401 Unauthorized

Pengepala tiada, salah format atau kunci tidak wujud.

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

Pastikan pengepala betul-betul Bearer <kunci> (ada ruang selepas Bearer) dan tiada aksara baris baharu di hujung kunci.

403 Forbidden

Kunci wujud tetapi tidak dibenarkan membuat permintaan ini — selalunya kerana kunci dinyahaktifkan atau akaun digantung. Semak status akaun dalam konsol dan hubungi sokongan jika puncanya tidak jelas.

Amalan terbaik keselamatan

Jangan letak kunci dalam kod klien

Jangan sematkan kunci dalam halaman web, aplikasi mudah alih atau program desktop. Sesiapa yang membuka pemeriksa pelayar boleh membacanya dan membelanjakan baki anda. Panggil API daripada pelayan anda sendiri dan sediakan titik akhir anda sendiri kepada pengguna.

Gunakan pemboleh ubah persekitaran

Linux / macOS

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

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

.env

# fail .env — masukkan ke dalam .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;

Putarkan kunci apabila perlu

Putarkan kunci setiap 3-6 bulan, dan serta-merta jika mengesyaki kebocoran. Padam kunci yang tidak lagi digunakan: kunci terbiar hanyalah risiko terbiar.

Had permintaan

Permintaan dihadkan bagi setiap kunci:

429 Too Many Requests

Apabila melebihi had, API membalas 429 dan respons mungkin membawa nilai retry_after dalam saat. Tunggu selama itu sebelum mencuba lagi; turunkan kadar permintaan, letakkan kerja dalam giliran, atau cuba semula dengan backoff eksponen dan bukan dalam gelung rapat.

Dasar cuba semula

Cuba semula hanya pada kegagalan yang jelas. Jangan cuba semula selepas timeout bacaan atau sambungan: endpoint penjanaan adalah segerak, jadi timeout mungkin bermakna pesanan sudah diterima dan sedang dijana — cuba semula mencipta pesanan berganda dan mencaj dua kali. Tetapkan timeout klien kepada 300 saat atau lebih dan, selepas sambungan terputus, periksa pesanan dengan GET /api/music/songs sebelum menghantar semula. Lihat "Masa menunggu dan tetapan timeout" dalam Gambaran keseluruhan API baharu.

Hantar semula dengan backoff eksponen dan bukan gelung 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

Soalan lazim

Bagaimanakah format kunci?

Bermula dengan sk- diikuti huruf dan angka, jumlahnya sekitar 50-60 aksara.

Bolehkah saya memanggil API terus daripada pelayar?

Secara teknikalnya boleh, tetapi jangan buat begitu dalam produksi: kunci akan kelihatan kepada semua pelawat. Gunakan bahagian belakang anda sebagai proksi.

Bagaimana saya tahu kunci masih sah?

Hantar sebarang permintaan yang disahkan. 200 bermakna ia berfungsi; 401 bermakna kunci tidak sah atau telah dihapuskan.

Kunci saya hilang. Apa perlu dibuat?

Kunci tidak boleh dipulihkan. Cipta yang baharu dalam konsol dan hapuskan yang lama.

Berapa banyak kunci boleh ada pada satu akaun?

Tiada had tetap. Gunakan satu kunci bagi setiap aplikasi atau persekitaran supaya boleh dibatalkan secara berasingan, dan padam yang tidak lagi digunakan.

Adakah kunci tamat tempoh?

Ia sah sehingga anda hapuskan atau tutup akaun. Memutar secara berkala ialah amalan yang baik.

Bagaimana saya memantau penggunaan?

Log masuk ke konsol: penggunaan setiap kunci disenaraikan di situ, termasuk bilangan permintaan, perbelanjaan dan tugasan terkini.

Halaman berkaitan

• Panduan pantas
• Model yang disokong