API pembuatan efek suara

Diperbarui 2026-09-18 · tim Suno-API

Deskripsi endpoint

Pembuatan efek suara menghasilkan beberapa detik audio, bukan sebuah lagu. Cocok untuk suara pendek seperti guntur, tetesan hujan, atau benturan, dan juga untuk efek transisi, ambience, serta loop drum; sebagian besar di bawah 5 detik dan terlama sekitar 20 detik. Mendukung mode sekali dan loop.

Endpoint: POST /api/music/sounds

Biaya: Berbayar, saat ini default 0,6 CNY per panggilan. Jumlah yang benar-benar ditagih mengikuti konfigurasi harga back-office saat ini.

Waktu tunggu dan timeout (penting): ini endpoint sinkron — pesanan baru diterima dan diteruskan ke pembuatan saat respons tiba. Dari pengukuran, sebagian besar permintaan merespons dalam 1-3 detik, sekitar 10% melewati 30 detik, dan terlama sekitar 230 detik. Setel timeout klien 300 detik atau lebih; tidak ada respons bukan berarti tidak ada yang dibuat, dan jangan mencoba ulang langsung setelah timeout (itu menduplikasi pesanan dan menagih dua kali). Jika koneksi terputus, periksa lagi nanti dengan GET /api/music/songs. Lihat "Waktu tunggu dan pengaturan timeout" di Ringkasan API baru.

Parameter permintaan

Headers

Parameter	Tipe	Wajib	Catatan
Authorization	string	ya	Bearer YOUR_API_KEY
Content-Type	string	ya	application/json

Parameter body

Parameter	Tipe	Wajib	Default	Catatan
model	string	tidak	suno-v6	Nama model untuk pelanggan: `suno-v6`, `suno-v6-wild`, atau `suno-v6-mini`
description	string	ya	-	Jelaskan suara yang Anda inginkan; frasa pendek dalam bahasa Inggris paling andal, misalnya `cinematic whoosh transition, bright impact`
title	string	tidak	-	Judul; jika tidak dikirim, bisa dibuat dari deskripsi
type	string	tidak	one_shot	Tipe: `one_shot` (sekali) atau `loop` (perulangan)
loop	boolean	tidak	false	Apakah diputar berulang; setara dengan menyetel `type` ke `loop`
bpm	number	tidak	-	BPM; harus angka lebih besar dari 0. Nilai tidak valid mengembalikan 400 (`invalid_sound_bpm`), bukan diabaikan diam-diam
key	string	tidak	-	Nada dasar, dalam format nama not (C-B) + `#`/`b` opsional + `Major`/`Minor` opsional, misalnya `C Major`, `C#m`, `Bb`; kosong atau `any` berarti tanpa batasan. Nilai tidak valid mengembalikan 400 (`invalid_sound_key`)

Contoh permintaan

curl -X POST https://www.suno-api.io/api/music/sounds \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "description": "cinematic whoosh transition, bright impact",
    "title": "cinematic whoosh",
    "type": "one_shot",
    "loop": false,
    "bpm": 120,
    "key": "C"
  }'

Respons

Mengembalikan array lagu; fieldnya sama dengan field respons lagu umum di Ringkasan API baru.

BerikutnyaAPI pembuatan lirik

Dapatkan kunci API

Buat kunci API di konsol setelah mendaftar. Setiap pembuatan berbiaya 0,6 ¥ dan menghasilkan 2 lagu, unduhan tidak terbatas, dan nomor telepon tidak diperlukan.

Ambil kunci API Kembali ke ringkasan