API generowania efektów dźwiękowych

Zaktualizowano 2026-09-18 · zespół Suno-API

Opis punktu końcowego

Generowanie efektów dźwiękowych tworzy kilka sekund dźwięku, a nie utwór. Nadaje się do krótkich brzmień, takich jak grzmot, krople deszczu czy uderzenie, a także do efektów przejściowych, ambientu i pętli perkusyjnych; większość trwa poniżej 5 sekund, a najdłuższa około 20 sekund. Obsługiwane są tryby jednorazowy i pętla.

Punkt końcowy: POST /api/music/sounds

Rozliczenie: Płatne, obecnie domyślnie 0,6 CNY za wywołanie. Faktycznie pobrana kwota zależy od aktualnej konfiguracji cen w panelu administracyjnym.

Czasy oczekiwania i limity czasu (ważne): to punkt końcowy synchroniczny — zamówienie zostaje przyjęte i przekazane do generowania dopiero, gdy przyjdzie odpowiedź. Z pomiarów: większość żądań odpowiada w 1-3 sekundy, około 10% przekracza 30 sekund, a najdłuższe trwa około 230 sekund. Ustaw limit czasu klienta na 300 sekund lub więcej; brak odpowiedzi nie oznacza, że nic nie zostało wygenerowane, a ponawianie od razu po limicie czasu duplikuje zamówienie i pobiera opłatę ponownie. Jeśli połączenie się zerwało, sprawdź później przez GET /api/music/songs. Zobacz „Czasy oczekiwania i ustawienia limitu czasu" w Przeglądzie nowego API.

Parametry żądania

Headers

Parametr	Typ	Wymagany	Uwagi
Authorization	string	tak	Bearer YOUR_API_KEY
Content-Type	string	tak	application/json

Parametry body

Parametr	Typ	Wymagany	Domyślnie	Uwagi
model	string	nie	suno-v6	Nazwa modelu dla klienta: `suno-v6`, `suno-v6-wild` lub `suno-v6-mini`
description	string	tak	-	Opisz dźwięk, jaki chcesz uzyskać; najstabilniej działają krótkie frazy po angielsku, np. `cinematic whoosh transition, bright impact`
title	string	nie	-	Tytuł; jeśli go nie podasz, może zostać wygenerowany z opisu
type	string	nie	one_shot	Typ: `one_shot` (jednorazowy) lub `loop` (pętla)
loop	boolean	nie	false	Czy odtwarzać w pętli; równoważne ustawieniu `type` na `loop`
bpm	number	nie	-	BPM; musi być liczbą większą od 0. Nieprawidłowa wartość zwraca 400 (`invalid_sound_bpm`) i nie jest po cichu ignorowana
key	string	nie	-	Tonacja w formacie nazwy dźwięku (C-B) + opcjonalny `#`/`b` + opcjonalny `Major`/`Minor`, np. `C Major`, `C#m`, `Bb`; puste lub `any` oznacza brak ograniczenia. Nieprawidłowa wartość zwraca 400 (`invalid_sound_key`)

Przykład żądania

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

Odpowiedź

Zwracana jest tablica utworów; pola są takie same jak wspólne pola odpowiedzi utworu w Przeglądzie nowego API.

NastępnyAPI generowania tekstu

Uzyskaj klucz API

Po rejestracji utwórz klucz API w konsoli. Każde generowanie kosztuje 0,6 ¥ i zwraca 2 utwory, pobierania są nieograniczone, a numer telefonu nie jest wymagany.

Pobierz klucz API Powrót do przeglądu