API för ljudeffekter

Uppdaterad 2026-09-18 · Suno-API-teamet

Beskrivning av ändpunkten

Ljudeffekter skapar några sekunder ljud, inte en låt. De passar korta ljud som åska, regndroppar eller en smäll och fungerar även för övergångseffekter, atmosfär och trumloopar; de flesta är under 5 sekunder och den längsta runt 20 sekunder. Både enkel och loop-läge stöds.

Ändpunkt: POST /api/music/sounds

Fakturering: Betalt, för närvarande 0,6 CNY per anrop som standard. Det faktiskt debiterade beloppet följer den aktuella prisinställningen i backoffice.

Väntetider och timeouts (viktigt): detta är en synkron ändpunkt — beställningen accepteras och lämnas till generering först när svaret kommer. Mätt: de flesta anrop svarar på 1-3 sekunder, omkring 10% tar längre än 30 sekunder och det längsta är cirka 230 sekunder. Ställ in klientens timeout på 300 sekunder eller mer; inget svar betyder inte att inget genererades, och försök inte igen direkt efter en timeout (det duplicerar beställningen och debiterar igen). Om anslutningen bröts, kontrollera senare med GET /api/music/songs. Se "Väntetider och timeout-inställningar" i Översikt över det nya API:t.

Begäransparametrar

Headers

Parameter	Typ	Krävs	Anmärkningar
Authorization	string	ja	Bearer YOUR_API_KEY
Content-Type	string	ja	application/json

Body-parametrar

Parameter	Typ	Krävs	Standard	Anmärkningar
model	string	nej	suno-v6	Modellnamn mot kund: `suno-v6`, `suno-v6-wild` eller `suno-v6-mini`
description	string	ja	-	Beskriv ljudet du vill ha; korta engelska fraser fungerar mest tillförlitligt, till exempel `cinematic whoosh transition, bright impact`
title	string	nej	-	Titel; utelämnas den kan den genereras från beskrivningen
type	string	nej	one_shot	Typ: `one_shot` (enkel) eller `loop` (loop)
loop	boolean	nej	false	Om den ska loopas; motsvarar att sätta `type` till `loop`
bpm	number	nej	-	BPM; måste vara ett tal större än 0. Ett ogiltigt värde ger 400 (`invalid_sound_bpm`) i stället för att tystas bort
key	string	nej	-	Tonart i formen notnamn (C-B) + valfritt `#`/`b` + valfritt `Major`/`Minor`, till exempel `C Major`, `C#m`, `Bb`; tomt eller `any` betyder utan begränsning. Ett ogiltigt värde ger 400 (`invalid_sound_key`)

Exempelbegäran

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

Svar

En array med låtar returneras; fälten är desamma som de gemensamma svarsfälten för låtar i Översikt över det nya API:t.

NästaAPI för låttextgenerering

Skaffa en API-nyckel

Skapa en API-nyckel i konsolen efter registreringen. Varje generering kostar 0,6 ¥ och returnerar 2 spår, nedladdningar är obegränsade och inget telefonnummer krävs.

Hämta API-nyckel Tillbaka till översikten