API di generazione di effetti sonori

Aggiornato il 2026-09-18 · team Suno-API

Descrizione dell'endpoint

La generazione di effetti sonori crea pochi secondi di audio, non un brano. È adatta a suoni brevi come tuoni, gocce di pioggia o un impatto, e anche a effetti di transizione, ambienti e loop di batteria; la maggior parte dura meno di 5 secondi e il più lungo circa 20 secondi. Sono supportate le modalità singola e loop.

Endpoint: POST /api/music/sounds

Fatturazione: A pagamento, attualmente 0,6 CNY per chiamata per impostazione predefinita. L'importo effettivamente addebitato segue la configurazione prezzi attuale del back-office.

Tempi di attesa e timeout (importante): è un endpoint sincrono — l'ordine viene accettato e passato alla generazione solo quando arriva la risposta. Dai dati misurati, la maggior parte delle richieste risponde in 1-3 secondi, circa il 10% supera i 30 secondi e la più lunga arriva a circa 230 secondi. Imposta il timeout del client a 300 secondi o più; nessuna risposta non significa che non sia stato generato nulla, e non ritentare subito dopo un timeout (duplica l'ordine e riaddebita). Se la connessione è caduta, verifica più tardi con GET /api/music/songs. Vedi «Tempi di attesa e impostazione del timeout» nella Panoramica della nuova API.

Parametri della richiesta

Headers

Parametro	Tipo	Obbligatorio	Note
Authorization	string	sì	Bearer YOUR_API_KEY
Content-Type	string	sì	application/json

Parametri del corpo

Parametro	Tipo	Obbligatorio	Predefinito	Note
model	string	no	suno-v6	Nome del modello lato cliente: `suno-v6`, `suno-v6-wild` o `suno-v6-mini`
description	string	sì	-	Descrivi il suono che vuoi; le frasi brevi in inglese funzionano in modo più affidabile, ad esempio `cinematic whoosh transition, bright impact`
title	string	no	-	Titolo; se non viene inviato, può essere generato dalla descrizione
type	string	no	one_shot	Tipo: `one_shot` (singolo) o `loop` (ciclo)
loop	boolean	no	false	Se ripetere in loop; equivale a impostare `type` su `loop`
bpm	number	no	-	BPM; deve essere un numero maggiore di 0. Un valore non valido restituisce 400 (`invalid_sound_bpm`) invece di essere ignorato in silenzio
key	string	no	-	Tonalità, nel formato nome della nota (C-B) + `#`/`b` opzionale + `Major`/`Minor` opzionale, ad esempio `C Major`, `C#m`, `Bb`; vuoto o `any` significa senza restrizione. Un valore non valido restituisce 400 (`invalid_sound_key`)

Esempio di richiesta

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"
  }'

Risposta

Viene restituito un array di brani; i campi sono gli stessi campi comuni di risposta del brano della Panoramica della nuova API.

AvantiAPI di generazione del testo

Ottenere una chiave API

Dopo la registrazione puoi creare una chiave API nella console. Ogni generazione costa 0,6 ¥ e restituisce 2 brani, i download sono illimitati e non serve un numero di telefono.

Ottieni chiave API Torna alla panoramica