API wzmacniania stylu

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

Opis punktu końcowego

Wzmacnianie stylu rozwija krótki tag stylu w pełniejszy opis stylu, lepiej dopasowany do generowania w Suno, a także potrafi wygenerować fragment stylu z pełnego tekstu utworu.

Punkt końcowy: POST /api/music/boost-style

Rozliczenie: Bezpłatnie w ramach limitu (maksymalnie 10 wywołań na minutę i 300 na dzień na użytkownika); po przekroczeniu darmowego limitu 0,1 ¥ za wywołanie.

Wykrywanie przekroczenia: po przekroczeniu darmowego limitu żądanie nadal wykonuje się normalnie, a nagłówki odpowiedzi zawierają X-Suno-Helper-Free: false i X-Suno-Helper-Over-Limit: minute (lub day), dzięki czemu klient może poinformować, że to wywołanie było płatne.

Zalecany model: suno-v6. Dostępne są suno-v6, suno-v6-wild i suno-v6-mini.

Wynik po chińsku: gdy treść żądania (originalTags/lyrics/user_guidance) zawiera chiński i nie deklaruje języka, usługa automatycznie dopisuje （请用中文描述） po original_tags oraz uzupełnia user_guidance=语言：简体中文；乐器名也用中文, aby zwiększyć trafność chińskich opisów stylu. Wartości faktycznie wysłane wracają w appliedOriginalTags i appliedUserGuidance w odpowiedzi. Jeśli wysyłana treść już wskazuje język (np. „opisz po chińsku uproszczonym"), usługa niczego nie zmienia.

Uwierzytelnianie

Parametry żądania

Przykład żądania

curl -X POST https://www.suno-api.io/api/music/boost-style \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "originalTags": "pop, piano, male vocal",
    "lyrics": "[Verse]\nZa oknem zapada noc\n[Chorus]\nIdziemy ku światłu",
    "user_guidance": "dodaj suonę i erhu, wokal męski, szybsze tempo",
    "instrumental": false
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "originalTags": "pop, piano, male vocal",
    "instrumental": false,
    "upsampledStyle": "Mandopop, expressive male vocal, warm piano ballad...",
    "requestId": "request_id"
  }
}

upsampledStyle to pełny opis stylu, który należy wpisać z powrotem w pole Style.