Audio

Suno V5

Suno API generuje muzykę o jakości studyjnej z promptów, stylów i tekstów, zwracając dwa utwory na jedno uruchomienie z asynchronicznym dostarczaniem przyjaznym dla produkcji.

$0.12 / use

2 utwory na uruchomienieAsynchroniczny przepływ pracyKontrola promptu i tekstu piosenkiMP3 + okładka

Parametry

Model Version*

Custom Mode*

Włączone

Title*

Style of Music*

Lyrics (optional but recommended)

Instrumental Only*

Wyłączone

Vocal Gender Preference

Wyjście

Wygenerowana treść pojawi się tutaj

Punkty końcowe

POSThttps://api.apixo.ai/api/v1/generateTask/sunoUtwórz zadanie

GEThttps://api.apixo.ai/api/v1/statusTask/suno?taskId={taskId}Status odpytywania

Uwierzytelnianie

Sprawdzanie dostępu do API...

Zaloguj się, aby odebrać darmowe kredyty, przetestować Playground i przejść do integracji API.

Treść żądania (body)

request_type

async

Użyj callback z callback_url dla webhooków.

provider

official

Zgodne z instrukcją Seedance 2.0.

input

obiekt

Tryb, prompt, referencje, rozmiar, czas trwania i ustawienia audio.

Parametry

request_typewymagane

Typselect

Use async to poll or callback to receive a webhook when ready.async · callback

callback_urlwarunkowy

Typtext

Publicly accessible URL for callback mode.Tylko w request_type=callback

modewymagane

Typselect

Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS

customModewymagane

Typboolean

Enable to control title/style/lyrics. When off, prompt-only mode is used.

titlewymagane

Typtext

Appears in metadata and can steer theme. Required when Custom Mode is on.Tylko w customMode=

stylewymagane

Typstring

Describe genre/mood/instrumentation. Required in Custom Mode.Tylko w customMode=

promptwarunkowy

Typstring

Provide full lyrics for sung output. Required when Instrumental is off.Tylko w customMode=

songDescriptionwymagane

Typstring

Simple mode: one field to steer both style and topic when Custom Mode is off.Tylko w customMode=

instrumentalwymagane

Typboolean

Turn on to generate backing track without vocals.

negativeTagswarunkowy

Typstring

Negative TagsTylko w customMode=

styleWeightwarunkowy

Typslider

How strongly to follow the Style description.Tylko w customMode=

weirdnessConstraintwarunkowy

Typslider

Push creativity/experimentation. Higher = wilder.Tylko w customMode=

audioWeightwarunkowy

Typslider

Balance audio vs lyrical fidelity. Higher favors audio fidelity.Tylko w customMode=

vocalGenderwarunkowy

Typselect

Best-effort vocal timbre preference (custom mode only).f · mTylko w customMode=

Parametr	Typ	Wymagane	Opis
`request_type`	select	wymagane	Use async to poll or callback to receive a webhook when ready.async · callback
`callback_url`	text	warunkowy	Publicly accessible URL for callback mode.Tylko w request_type=callback
`mode`	select	wymagane	Choose the generation backend. V5 is fastest with the best vocals.V5 · V4_5 · V4_5PLUS
`customMode`	boolean	wymagane	Enable to control title/style/lyrics. When off, prompt-only mode is used.
`title`	text	wymagane	Appears in metadata and can steer theme. Required when Custom Mode is on.Tylko w customMode=
`style`	string	wymagane	Describe genre/mood/instrumentation. Required in Custom Mode.Tylko w customMode=
`prompt`	string	warunkowy	Provide full lyrics for sung output. Required when Instrumental is off.Tylko w customMode=
`songDescription`	string	wymagane	Simple mode: one field to steer both style and topic when Custom Mode is off.Tylko w customMode=
`instrumental`	boolean	wymagane	Turn on to generate backing track without vocals.
`negativeTags`	string	warunkowy	Negative TagsTylko w customMode=
`styleWeight`	slider	warunkowy	How strongly to follow the Style description.Tylko w customMode=
`weirdnessConstraint`	slider	warunkowy	Push creativity/experimentation. Higher = wilder.Tylko w customMode=
`audioWeight`	slider	warunkowy	Balance audio vs lyrical fidelity. Higher favors audio fidelity.Tylko w customMode=
`vocalGender`	select	warunkowy	Best-effort vocal timbre preference (custom mode only).f · mTylko w customMode=

Przykład (cURL)

curl -X POST "https://api.apixo.ai/api/v1/generateTask/suno" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "request_type": "async",
    "mode": "V5",
    "title": "Neon Freeway Nights",
    "style": "Synthwave, dreamy pop",
    "prompt": "Two verses about cruising the city at midnight under neon rain, feeling hopeful.",
    "songDescription": "A dreamy synthwave song about neon city nights and freedom.",
    "customMode": true,
    "instrumental": false,
    "negativeTags": "off-key vocals, muddy mix",
    "styleWeight": 0.7,
    "weirdnessConstraint": 0.25,
    "audioWeight": 0.6,
    "vocalGender": "f"
  }'

Pełna dokumentacja API

Przykładowe wyniki

Wygenerowano za pomocą API Suno V5 na APIXO

2 Ścieżki

Neon Freeway Nights

Widok

Kompletny przewodnik

Czym jest API Suno?

Suno API to interfejs generowania tekstu na muzykę zaprojektowany dla szybkich procesów produkcyjnych. Potrafi zamienić prompty, tagi stylu i niestandardowe teksty w dwa kompletne utwory wraz z powiązanymi okładkami.

Dzięki temu idealnie nadaje się do narzędzi dla twórców, generowania treści markowych i automatycznej produkcji muzyki, gdzie szybka iteracja jest ważniejsza niż ręczna kompozycja.

Jak działa proces generowania

Prześlij żądanie generowania z parametrami trybu samego promptu lub niestandardowych tekstów piosenek.
Otrzymuj status zadania asynchronicznie poprzez odpytywanie (polling) lub punkt końcowy callback.
W przypadku sukcesu zużywa dwie wygenerowane ścieżki wraz z odpowiednimi metadanymi grafiki.

Specyfikacja techniczna Suno API

Charakterystyka operacyjna istotna dla integracji produktu i backendu.

Wyniki

2 utwory na generowanie

Powierzchnia kontrolna

Styl, dziwność, waga dźwięku

Tryby generowania

Tryb samego promptu i niestandardowego tekstu piosenki

Dostarczenie

Asynchroniczny polling lub callback

Kluczowe możliwości

Wyjście dwuścieżkowe

Każde generowanie zwraca dwa warianty utworu, co przyspiesza selekcję A/B i iterację kreatywną dla zespołów produkcyjnych.

Suwaki kontroli kreatywnej

Dostosuj wagę stylu, dziwność (weirdness) i wagę dźwięku, aby przejść od bezpiecznych komercyjnych utworów do eksperymentalnych tekstur.

Procesy pracy z tekstami i wokalami

Obsługuje generowanie tylko z promptu oraz tryb niestandardowych tekstów z opcjonalnymi preferencjami dotyczącymi instrumentów i płci wokalu.

Gotowość do integracji asynchronicznej

Działa ze strategiami odpytywania (polling) lub wywołań zwrotnych (callback), co ułatwia integrację z backendowymi przepływami pracy opartymi na kolejkach.

Co możesz zbudować?

Generowanie muzyki w aplikacji

Generuj brandowane fragmenty muzyczne i utwory przyjazne twórcom dla UGC, krótkich wideo i narzędzi społecznościowych.

Branding podcastów i wideo

Twórz ścieżki intro i outro, dżingle oraz powracające motywy przewodnie z możliwością kontroli nastroju i tempa.

Ścieżki dźwiękowe do krótkich treści

Twórz niestandardową muzykę w tle dla TikTok, Shorts i Reels z szybką iteracją stylu i chwytliwych tekstów.

Audio do gier i interaktywne

Prototypuj pętle ambientowe, motywy menu i lekkie pomysły na ścieżkę dźwiękową do gier i interaktywnych doświadczeń.

Uwagi i ograniczenia

Każde generowanie zwraca dokładnie dwie ścieżki; liczba wyjściowa nie może być dostosowana.
Przepływ pracy w Playground jest domyślnie asynchroniczny; orkiestracja callbacków jest dostępna na poziomie API.
Długość promptu/tekstu w trybie Custom jest ograniczona do 5 000 znaków w obsługiwanych wersjach.
Płeć i charakterystyka głosu są kontrolowane na zasadzie „best-effort”, nie stanowią ścisłej gwarancji.

Często zadawane pytania

Zacznij budować

Wypróbuj powyższy playground, a gdy będziesz gotowy do integracji, przejdź do dokumentacji API.

Wypróbuj playground Zobacz dokumentację API

Suno V5

Przykładowe wyniki

Czym jest API Suno?

Jak działa proces generowania

Specyfikacja techniczna Suno API

Wyniki

Powierzchnia kontrolna

Tryby generowania

Dostarczenie

Kluczowe możliwości

Wyjście dwuścieżkowe

Suwaki kontroli kreatywnej

Procesy pracy z tekstami i wokalami

Gotowość do integracji asynchronicznej

Co możesz zbudować?

Generowanie muzyki w aplikacji

Branding podcastów i wideo

Ścieżki dźwiękowe do krótkich treści

Audio do gier i interaktywne

Uwagi i ograniczenia

Często zadawane pytania

Czy mogę wygenerować tylko jedną ścieżkę zamiast dwóch?

Czy mogę wymusić dokładny tekst utworu?

Czy to API jest synchroniczne?

Jaki typ pliku jest zwracany?

Zacznij budować