API penjanaan kesan bunyi

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

Penerangan endpoint

Penjanaan kesan bunyi menghasilkan beberapa saat audio, bukan sebuah lagu. Sesuai untuk bunyi pendek seperti guruh, titisan hujan atau hentaman, dan juga untuk kesan peralihan, ambien serta gelung dram; kebanyakannya bawah 5 saat dan paling lama sekitar 20 saat. Menyokong mod sekali dan gelung.

Endpoint: POST /api/music/sounds

Pengebilan: Berbayar, kini lalai 0.6 CNY setiap panggilan. Jumlah yang benar-benar dicaj mengikut tetapan harga back-office semasa.

Masa menunggu dan timeout (penting): ini endpoint segerak — pesanan hanya diterima dan dihantar ke penjanaan apabila respons tiba. Berdasarkan ukuran, kebanyakan permintaan membalas dalam 1-3 saat, kira-kira 10% melebihi 30 saat dan paling lama sekitar 230 saat. Tetapkan timeout klien kepada 300 saat atau lebih; tiada respons tidak bermakna tiada apa-apa dijana, dan jangan cuba semula sejurus selepas timeout (ia menggandakan pesanan dan mencaj dua kali). Jika sambungan terputus, periksa kemudian dengan GET /api/music/songs. Lihat "Masa menunggu dan tetapan timeout" dalam Gambaran keseluruhan API baharu.

Parameter permintaan

Headers

Parameter	Jenis	Wajib	Nota
Authorization	string	ya	Bearer YOUR_API_KEY
Content-Type	string	ya	application/json

Parameter body

Parameter	Jenis	Wajib	Lalai	Nota
model	string	tidak	suno-v6	Nama model untuk pelanggan: `suno-v6`, `suno-v6-wild` atau `suno-v6-mini`
description	string	ya	-	Terangkan bunyi yang anda mahukan; frasa pendek bahasa Inggeris paling stabil, contohnya `cinematic whoosh transition, bright impact`
title	string	tidak	-	Tajuk; jika tidak dihantar, boleh dijana daripada penerangan
type	string	tidak	one_shot	Jenis: `one_shot` (sekali) atau `loop` (gelung)
loop	boolean	tidak	false	Sama ada dimainkan berulang; sama seperti menetapkan `type` kepada `loop`
bpm	number	tidak	-	BPM; mesti nombor lebih besar daripada 0. Nilai tidak sah mengembalikan 400 (`invalid_sound_bpm`) dan tidak diabaikan secara senyap
key	string	tidak	-	Nada, dalam format nama not (C-B) + `#`/`b` pilihan + `Major`/`Minor` pilihan, contohnya `C Major`, `C#m`, `Bb`; kosong atau `any` bermaksud tanpa had. Nilai tidak sah 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

Tatasusunan lagu dipulangkan; medannya sama seperti medan respons lagu umum dalam Gambaran keseluruhan API baharu.

SeterusnyaAPI penjanaan lirik

Dapatkan kunci API

Cipta kunci API dalam konsol selepas mendaftar. Setiap penjanaan berharga 0.6 ¥ dan mengembalikan 2 lagu, muat turun tanpa had dan nombor telefon tidak diperlukan.

Dapatkan kunci API Kembali ke gambaran