API sugestii promptów

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

Opis punktu końcowego

Punkt końcowy sugestii promptów zwraca losowe opisy utworów, tematy tekstów i propozycje tagów stylu. Nadaje się do przycisków „losowa inspiracja" i „odśwież tagi".

Punkt końcowy: POST /api/prompts/suggestions

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.

Uwierzytelnianie

Parametry żądania

Przykład żądania

curl -X POST https://www.suno-api.io/api/prompts/suggestions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6"
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "prompts": ["A dreamy synth-pop track about city lights after rain"],
    "lyrics_prompts": ["Napisz polski tekst o nocy, ponownym spotkaniu i żalu"],
    "tags": ["dreamy synth-pop", "warm piano", "male vocal"],
    "is_pending_personalization": false
  }
}

Opis pól