API generowania tekstu

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

Opis punktu końcowego

Generowanie tekstu tworzy lub przepisuje tekst na podstawie tematu, kontekstu istniejącego tekstu i wymagań stylistycznych. Ten punkt końcowy został już przeniesiony na najnowszy kontrakt generowania tekstu i można go używać bezpośrednio do generowania w trybie profesjonalnym.

Punkt końcowy: POST /api/lyrics/generate

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 CNY 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

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

Parametry żądania

Parametr	Typ	Wymagany	Domyślnie	Uwagi
model	string	tak	-	Nazwa modelu dla klienta: `suno-v6`, `suno-v6-wild` lub `suno-v6-mini`
instruction	string	tak	-	Temat tekstu lub wymaganie dotyczące generowania
style	string	nie	-	Wymaganie stylistyczne
title	string	nie	-	Tytuł utworu lub ograniczenie tytułu
selected	string	nie	`""`	Wybrany tekst do przepisania
context_before	string	nie	`""`	Kontekst poprzedzający
context_after	string	nie	`""`	Kontekst następujący
mode	string	nie	`apply_user_request`	Tryb generowania tekstu
references	array	nie	`[]`	Lista materiałów referencyjnych
num_variants	integer	nie	`null`	Żądana liczba wariantów tekstu
lyricist_id	string	nie	`null`	Identyfikator konkretnego autora tekstu (lista autorów została wycofana; nowa integracja niezalecana)
metadata	object	nie	-	Parametry rozszerzone; obsługuje `lyrics_model` i `enable_thinking`
lyrics_project_id	string	nie	`null`	Identyfikator istniejącego projektu tekstu (seria projektów tekstu została wycofana; nowa integracja niezalecana)

instruction przyjmuje także stare pola theme i prompt. metadata.lyrics_model ma domyślnie wartość default, a metadata.enable_thinking domyślnie false.

Sterowanie językiem

Ten punkt końcowy nie ma osobnego pola żądania language. Język tekstu zależy od treści instruction; style może odgrywać jedynie rolę pomocniczą.

Aby uzyskać tekst po chińsku, wskaż język docelowy wyraźnie w instruction, na przykład:

{
  "model": "suno-v6",
  "instruction": "请用中文写歌词，主题是夏夜海边重逢",
  "style": "Mandopop, 中文流行"
}

Możesz też napisać "Write the lyrics in Chinese about ...". Aby uzyskać tekst po angielsku, napisz "请用英文写歌词" lub "Write the lyrics in English". Jeśli podasz tylko angielski temat bez wskazania języka docelowego, wynik może być po angielsku.

Przykład żądania

curl -X POST https://www.suno-api.io/api/lyrics/generate \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "suno-v6",
    "instruction": "Tekst piosenki po polsku o zakończeniu szkoły i nowym starcie",
    "style": "pop rock, szczerze, zapadający w pamięć refren",
    "title": "Nowy start",
    "metadata": {
      "lyrics_model": "default",
      "enable_thinking": false
    }
  }'

Odpowiedź

{
  "code": 200,
  "message": "success",
  "data": {
    "lyrics": "[Verse]\nWiatr przebiega przez boisko\nŻegnamy wczoraj",
    "edited_lyrics": "[Verse]\nWiatr przebiega przez boisko\nŻegnamy wczoraj",
    "lyrics_id": "lyrics_id",
    "lyrics_request_id": "lyrics_request_id"
  }
}

edited_lyrics to pełny tekst, który należy wpisać w polu tekstu utworu. lyrics_id i lyrics_request_id służą do śledzenia i mogą być puste w zależności od tego, co zwróci punkt końcowy; nie traktuj ich jako identyfikatorów utworu.

Uwagi o zgodności

Stare pola theme i prompt nadal działają i są mapowane na instruction.
Seria punktów końcowych projekt tekstu / autor tekstu została wycofana: jeśli chcesz zachować wygenerowane wyniki, zapisz zwrócony przez punkt końcowy edited_lyrics samodzielnie.

NastępnyAPI klonowania głosu i generowania ze wskazanym głosem (niezalecane)

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