Producent Audios Generation API - instrukcja integracji

W tym dokumencie przedstawimy instrukcję integracji z Producent Audios Generation API, która umożliwia generowanie oficjalnej muzyki Producenta za pomocą wprowadzonych parametrów.

Proces aplikacji

Aby skorzystać z Producent Audios Generation API, najpierw przejdź do Ace Data Cloud Console, aby uzyskać swój token API, który należy zachować na przyszłość.

Jeśli nie jesteś zalogowany lub zarejestrowany, automatycznie zostaniesz przekierowany na stronę logowania, aby zarejestrować się i zalogować, a po zakończeniu zostaniesz automatycznie przekierowany z powrotem na bieżącą stronę. Jeden token API wystarczy do korzystania ze wszystkich usług platformy, nie ma potrzeby składania osobnych wniosków dla każdej usługi. Przy pierwszym wniosku otrzymasz darmowy limit, aby móc go przetestować; w przypadku niewystarczającego limitu możesz doładować saldo ogólne w konsoli.

📘 Pełna dokumentacja: Producent Audios Generation API →

Podstawowe użycie

Chcąc stworzyć piosenkę, możesz wprowadzić dowolny tekst, na przykład, jeśli chcesz wygenerować piosenkę o tematyce świątecznej, możesz wpisać a song for Christmas, jak pokazano na obrazku:

Można zauważyć, że ustawiliśmy nagłówki żądania, w tym:

accept: w jakim formacie chcesz otrzymać odpowiedź, tutaj wpisujemy application/json, czyli format JSON.
authorization: klucz do wywołania API, po złożeniu wniosku można go bezpośrednio wybrać z rozwijanej listy.

Dodatkowo parametry ciała żądania obejmują:

action: działanie związane z generowaniem muzyki, w przypadku generowania piosenki to generate.
model: model używany do tworzenia piosenki, obecnie dostępne są głównie: FUZZ-2.0 Pro, FUZZ-2.0, FUZZ-2.0 Raw, FUZZ-1.1 Pro, FUZZ-1.0 Pro, FUZZ-1.0, FUZZ-1.1, FUZZ-0.8.
lyric: treść tekstu piosenki.
custom: czy piosenka ma być generowana w sposób niestandardowy.
prompt: słowo kluczowe w trybie inspiracji.
title: informacja o tytule piosenki.
audio_id: ID referencyjnej piosenki, używane do kontynuacji/odtworzenia itp.
continue_at: kontynuacja od określonej sekundy.
replace_section_start/replace_section_end: czas rozpoczęcia i zakończenia wymiany fragmentu, w sekundach.
lyrics_strength: siła tekstu, wskazująca na wpływ tekstu na generowanie audio, opcjonalnie od 0 do 1, domyślnie 0.7.
sound_strength: siła słowa kluczowego audio, opcjonalnie od 0.2 do 1, domyślnie 0.7.
cover_strength: siła coveru od 0.2 do 1, domyślnie 1.
weirdness: stopień dziwności stylu, opcjonalnie od 0 do 1, domyślnie 0.5.
callback_url: URL, na który mają być zwracane wyniki.
async: opcjonalnie, ustawione na true, interfejs natychmiast zwraca task_id, nie ma potrzeby podawania callback_url, a następnie można uzyskać wyniki, wykonując zapytania do odpowiedniego interfejsu zadań.
instrumental: czy ma to być tryb bez tekstu.

Po dokonaniu wyboru, można zauważyć, że po prawej stronie wygenerowano odpowiedni kod, jak pokazano na obrazku:

Kliknij przycisk „Try”, aby przeprowadzić test, jak pokazano na powyższym obrazku, a otrzymasz następujący wynik:

{
  "success": true,
  "task_id": "82fd443a-903a-4f18-8028-12d2f8a0a4be",
  "trace_id": "d85839fa-0bb1-42da-a9fc-cd582c29027d",
  "data": [
    {
      "id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "title": "Untitled",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Instrumental]",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "6c947f13-a3c5-4b9c-8609-5639c37cdc2d",
      "topic": null,
      "seed": "2450882164",
      "sound": "A song for Christmas",
      "created_at": "2025-12-30T17:18:23.232911Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "181.3014058956916"
    }
  ]
}

W zwróconym wyniku znajduje się wiele pól, które są opisane poniżej:

success, stan zadania generowania muzyki w danym momencie.
- data, wynik zadania muzycznego
  - id, ID zadania generowania muzyki w danym momencie.
  - sound, słowo kluczowe zadania generowania muzyki w danym momencie.
  - seed, wartość nasionka zadania generowania muzyki w danym momencie.
  - audio_url, link do audio zadania generowania muzyki w danym momencie.
  - image_url, link do okładki zadania generowania muzyki w danym momencie.
  - image_id, ID okładki zadania generowania muzyki w danym momencie.
  - state, stan zadania generowania muzyki w danym momencie.
  - duration, informacja o czasie trwania muzyki w danym momencie.
  - progress, wartość postępu zadania muzycznego w danym momencie.
  - model, informacja o modelu używanym w zadaniu generowania muzyki w danym momencie.
  - lyric, informacja o tekście zadania generowania muzyki w danym momencie.

Można zauważyć, że otrzymaliśmy informacje o muzyce, którą chcieliśmy wygenerować, wystarczy, że na podstawie adresu linku audio w data uzyskamy wygenerowaną muzykę Producenta. Jeśli chcesz wygenerować odpowiedni kod do integracji, możesz go bezpośrednio skopiować, na przykład kod CURL wygląda następująco:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "prompt": "A song for Christmas"
}'

Niestandardowe generowanie

Jeśli chcesz niestandardowo wygenerować tekst, możesz wprowadzić tekst piosenki: W tym momencie pole lyric może przyjąć podobną treść jak poniżej:

[Verse]Woke up with the sun in my eyesNo clouds above just blue in the skiesShoes on my feet I’m ready to runEvery step feels like a loaded gun[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Verse 2]Dancing through the city streetsA rhythm pounding in my heartbeatStrangers smile it’s catching onThis world’s a stage we’re all a song[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high[Bridge]Throw your worries out the doorLet them sink to the ocean floorWe’re alive and it’s enoughLife is messy but it’s love[Chorus]Happy days are rolling inLet the joy beneath my skinNo more shadows no more liesJust the truth that lifts me high

Następnie, aby dostosować generowanie piosenki na podstawie tekstu, tytułu i stylu, można określić następujące treści:

lyric：tekst piosenki
custom：wypełnij jako true, co oznacza generację niestandardową, ten parametr domyślnie ma wartość false, co oznacza użycie prompt do generacji.
title：tytuł piosenki.

Wypełniony przykład wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "generate",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "custom": true
}'

Testowanie dozwolone, generowany efekt jest podobny.

{
  "success": true,
  "task_id": "9f58bbd4-855a-4233-ac45-b63bf9168e02",
  "trace_id": "145ad117-6ce7-42dd-af12-70751c5284fc",
  "data": [
    {
      "id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "title": "Woke up with the sun in my eyes",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
      "topic": null,
      "seed": "3789209121",
      "sound": "",
      "created_at": "2025-12-30T17:26:46.357055Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.80897959183673"
    }
  ]
}

Przykład coveru piosenki

Jeśli chcesz wykonać cover już wygenerowanej piosenki, możesz wprowadzić wcześniej wygenerowaną piosenkę do wykonania coveru, następnie musimy dostosować generację piosenki na podstawie tekstu, tytułu. Jeśli chcesz kontynuować wykonywanie coveru swojej przesłanej piosenki, możesz ustawić parametr action na upload_cover i wprowadzić ID piosenki, którą chcesz kontynuować, ID piosenki można uzyskać za pomocą Producer Upload API, jak pokazano na poniższym obrazku:

Możesz określić następujące treści:

action：działanie zadania piosenki, obecnie wspiera: generate, cover, extend, upload_cover, upload_extend, replace_section, swap_vocals, swap_instrumentals, variation, w tym przypadku używamy parametru cover.
lyric：tekst piosenki
title：tytuł piosenki.
custom：czy używać trybu niestandardowego do generacji, domyślnie jest false.
audio_id：ID piosenki, którą chcesz wykonać cover.

Wypełniony przykład wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "cover",
  "model": "FUZZ-2.0 Pro",
  "lyric": "[Verse]\nWoke up with the sun in my eyes\nNo clouds above just blue in the skies\nShoes on my feet I’m ready to run\nEvery step feels like a loaded gun\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Verse 2]\nDancing through the city streets\nA rhythm pounding in my heartbeat\nStrangers smile it’s catching on\nThis world’s a stage we’re all a song\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high\n[Bridge]\nThrow your worries out the door\nLet them sink to the ocean floor\nWe’re alive and it’s enough\nLife is messy but it’s love\n[Chorus]\nHappy days are rolling in\nLet the joy beneath my skin\nNo more shadows no more lies\nJust the truth that lifts me high",
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "instrumental": false,
  "custom": true,
  "title": "Cover"
}'

Testowanie dozwolone, generowany efekt jest podobny.

{
  "success": true,
  "task_id": "dbca350e-6fb9-46ca-9c7e-4c1a9080806f",
  "trace_id": "a39e0fff-ced8-4b31-ae23-aef3badd90fa",
  "data": [
    {
      "id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "title": "Okładka",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nNie ma chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się rozprzestrzenia\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "e52dd729-38b4-4c2f-9031-59eb7953c593",
      "topic": null,
      "seed": "358803418",
      "sound": "",
      "created_at": "2025-12-30T17:32:32.951948Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "153.0659410430839"
    }
  ]
}

Kontynuacja piosenki

Jeśli chcesz kontynuować piosenkę, musimy przekazać parametr action z wartością: extend, następnie musimy dostosować generowanie piosenki na podstawie tekstu, tytułu i stylu. Jeśli chcesz kontynuować piosenkę, którą sam przesłałeś, możesz ustawić parametr action na upload_extend i wprowadzić ID piosenki, którą chcesz kontynuować. ID piosenki można uzyskać za pomocą Producer Upload API, jak pokazano na poniższym obrazku:

Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "extend",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nNie ma chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się rozprzestrzenia\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko",
  "continue_at": 3,
  "audio_id": "38d3b9e2-0dfb-4338-b2a7-15e45656ed32",
  "custom": true,
  "title": "Rozszerzenie",
  "weirdness": 0.3,
  "sound_strength": 0.3,
  "lyrics_strength": 0.6
}'

Testowanie dozwolone, wygenerowany efekt jest podobny.

{
  "success": true,
  "task_id": "834983cb-d62d-4750-b1aa-461da137e51f",
  "trace_id": "6923eee2-7403-432c-8bd1-e471086385b0",
  "data": [
    {
      "id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "title": "Rozszerzenie",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Zwrotka]\n[Zwrotka]\nObudziłem się z słońcem w oczach\nNie ma chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się rozprzestrzenia\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
      "topic": null,
      "seed": "4294469624",
      "sound": "",
      "created_at": "2025-12-30T17:36:14.520928Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.87102040816328"
    }
  ]
}

Muzyczna transformacja

Jeśli chcesz wygenerować nową muzykę o podobnym efekcie na podstawie wartości seed poprzedniej piosenki, musimy przekazać parametr action z wartością: variation, następnie możemy dostosować generowanie nowej muzyki o podobnym efekcie. Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "variation",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nBrak chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się rozprzestrzenia\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko",
  "custom": true
}'

{
    "success": true,
    "task_id": "3a74da6d-a37d-4b5d-b116-821f455bce39",
    "trace_id": "8e28cce0-0400-4bfd-83db-6d27f97422c7",
    "data": [
        {
            "id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "title": "Obudziłem się z słońcem w oczach",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nBrak chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się rozprzestrzenia\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która unosi mnie wysoko",
            "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
            "video_url": null,
            "image_id": "c14ca458-cd5a-4700-83d4-5249e15f2707",
            "topic": null,
            "seed": "2082104582",
            "sound": "",
            "created_at": "2025-12-30T17:48:40.135187Z",
            "model": "FUZZ-2.0",
            "progress": "100%",
            "state": "succeeded",
            "duration": "173.12798185941043"
        }
    ]
}

Zastąpienie fragmentu

Jeśli chcesz zastąpić fragment piosenki, musimy przekazać wartość parametru action jako: replace_section, następnie musimy dostosować tekst piosenki na podstawie tekstu, tytułu. Jeśli chcesz kontynuować zastępowanie fragmentu w przesłanej przez siebie piosence, możesz ustawić parametr action na upload_replace_section i wprowadzić ID przesłanej piosenki, które można uzyskać za pomocą Producer Upload API, jak pokazano na poniższym obrazku:

Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "replace_section",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Zwrotka]\\nObudziłem się z słońcem w oczach\\nBrak chmur, tylko niebieskie niebo\\nButy na nogach, jestem gotowy do biegu\\nKażdy krok czuje się jak naładowany pistolet\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która unosi mnie wysoko\\n[Zwrotka 2]\\nTańcząc przez ulice miasta\\nRytm bije w moim sercu\\nObcy się uśmiechają, to się rozprzestrzenia\\nTen świat to scena, wszyscy jesteśmy piosenką\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która unosi mnie wysoko\\n[Most]\\nWyrzuć swoje zmartwienia za drzwi\\nNiech zatoną na dnie oceanu\\nJesteśmy żywi i to wystarczy\\nŻycie jest chaotyczne, ale to miłość\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która unosi mnie wysoko",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "replace_section_start": 3,
  "replace_section_end": 70,
  "custom": true
}'

Testy są dozwolone, generowany efekt jest podobny.

{
    "success": true,
    "task_id": "3cb5ae96-01b0-4a37-afb0-e582608af56f",
    "trace_id": "3ebc6f63-5093-4499-bf9b-95c239e0da4f",
    "data": [
        {
            "id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "title": "Obudziłem się z słońcem w oczach",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Zwrotka]\\nObudziłem się z słońcem w oczach\\nBrak chmur nad głową, tylko niebieskie niebo\\nButy na nogach, jestem gotowy do biegu\\nKażdy krok czuje się jak naładowany pistolet\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która mnie unosi\\n[Zwrotka 2]\\nTańcząc przez ulice miasta\\nRytm bije w moim sercu\\nObcy się uśmiechają, to się zaraża\\nTen świat to scena, wszyscy jesteśmy piosenką\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która mnie unosi\\n[Mostek]\\nWyrzuć swoje zmartwienia za drzwi\\nNiech zatoną na dnie oceanu\\nJesteśmy żywi i to wystarczy\\nŻycie jest chaotyczne, ale to miłość\\n[Refren]\\nSzczęśliwe dni nadchodzą\\nNiech radość pod moją skórą\\nKoniec cieni, koniec kłamstw\\nTylko prawda, która mnie unosi",
            "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
            "video_url": null,
            "image_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f",
            "topic": null,
            "seed": "14887454",
            "sound": "",
            "created_at": "2025-12-30T18:01:19.907443Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "174.6140589569161"
        }
    ]
}

Przeróbka podkładu

Jeśli chcesz użyć oficjalnej przeróbki podkładu, możesz ustawić wartość parametru action na: swap_instrumentals, następnie musimy dostosować generowanie piosenki na podstawie tekstu, tytułu. Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_instrumentals",
  "model": "FUZZ-2.0 Pro",
  "weirdness": 0.6,
  "prompt": "Szczęśliwy",
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4"
}'

Testowanie dozwolone, wygenerowany efekt jest podobny.

{
  "success": true,
  "task_id": "d17d8376-3a58-451d-a976-404719bac11d",
  "trace_id": "ab596807-910a-4e30-bae2-4647895f7d0b",
  "data": [
    {
      "id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "title": "Rozszerz (Zamiana dźwięku)",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nBrak chmur nad głową, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się zaraża\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi\n[Mostek]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "22d7d75c-9e0a-47a8-b22b-eea55eaa0c4b",
      "topic": null,
      "seed": "2157878068",
      "sound": "Szczęśliwy",
      "created_at": "2025-12-30T18:09:49.594800Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "172.3849433106576"
    }
  ]
}

Przeróbka wokalu

Jeśli chcesz użyć oficjalnej przeróbki wokalu, możesz ustawić wartość parametru action na: swap_vocals, następnie musimy dostosować generowanie piosenki na podstawie tekstu, tytułu, stylu. Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "swap_vocals",
  "model": "FUZZ-2.0 Pro",
  "instrumental": false,
  "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nBrak chmur nad głową, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się zaraża\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi\n[Mostek]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nKoniec cieni, koniec kłamstw\nTylko prawda, która mnie unosi",
  "weirdness": 0.6,
  "lyrics_strength": 0.8,
  "audio_id": "d9ebc609-fb65-4a23-b914-c074747af6a4",
  "custom": true
}'

Testowanie dozwolone, wygenerowany efekt jest podobny.

{
  "success": true,
  "task_id": "a903ac38-f129-4f85-9181-b1dc5579bd32",
  "trace_id": "9953af52-45e0-4808-bf13-88f0b21262c1",
  "data": [
    {
      "id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "title": "Obudziłem się z słońcem w oczach",
      "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
      "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nNie ma chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak naładowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się zaraża\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko\n[Mostek]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nNie ma więcej cieni, nie ma więcej kłamstw\nTylko prawda, która unosi mnie wysoko",
      "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
      "video_url": null,
      "image_id": "7b2d653b-aaaa-41b0-b737-aee4c4c5693b",
      "topic": null,
      "seed": "2484735707",
      "sound": "",
      "created_at": "2025-12-30T18:13:01.349875Z",
      "model": "FUZZ-2.0 Pro",
      "progress": "100%",
      "state": "succeeded",
      "duration": "173.12798185941043"
    }
  ]
}

Oddzielanie tekstu od muzyki

Jeśli chcesz użyć oficjalnej operacji oddzielania tekstu od muzyki, możesz ustawić wartość parametru action na: stems, następnie musimy przeprowadzić oddzielanie tekstu od muzyki na podstawie ID utworu. Przykład wypełnienia wygląda następująco:

Po wypełnieniu automatycznie wygenerowano kod jak poniżej:

Odpowiedni kod:

curl -X POST 'https://api.acedata.cloud/producer/audios' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "action": "stems",
  "audio_id": "a54609c6-13e2-4176-be0f-4d7eebc68e1f"
}'

Testowanie dozwolone, wygenerowany efekt jest podobny.

{
    "success": true,
    "task_id": "561ac695-b4aa-47cf-978d-fb7be2b9ebfc",
    "trace_id": "66d0d397-2987-4bde-84fb-a60d0023b217",
    "data": [
        {
            "title": "Obudziłem się z słońcem w oczach",
            "lyric": "",
            "stems_url": "https://platform.cdn.acedata.cloud/producer/561ac695-b4aa-47cf-978d-fb7be2b9ebfc.zip",
            "model": "",
            "progress": "100%",
            "state": "succeeded"
        }
    ]
}

Asynchroniczne wywołanie zwrotne

Ponieważ czas generacji API Producer Audios może być czasami stosunkowo długi, jeśli API nie odpowiada przez dłuższy czas, żądanie HTTP będzie utrzymywać połączenie, co prowadzi do dodatkowego zużycia zasobów systemowych, dlatego to API oferuje również wsparcie dla asynchronicznych wywołań zwrotnych. Cały proces polega na tym, że klient inicjuje żądanie, dodatkowo określając pole callback_url, po zainicjowaniu żądania API, API natychmiast zwraca wynik, zawierający pole task_id, które reprezentuje aktualne ID zadania. Gdy zadanie zostanie zakończone, wynik generacji zadania zostanie wysłany do określonego przez klienta callback_url w formie POST JSON, w tym również zawierając pole task_id, dzięki czemu wynik zadania można powiązać za pomocą ID. Poniżej przyjrzymy się, jak dokładnie to działa na przykładzie. Po pierwsze, wywołanie zwrotne Webhook to usługa, która może odbierać żądania HTTP, deweloperzy powinni zastąpić to URL swojego własnego serwera HTTP. W tym celu, dla wygody demonstracji, użyjemy publicznej strony przykładowej Webhook https://webhook.site/, otwierając tę stronę, można uzyskać URL Webhook, jak pokazano na obrazku:

Skopiuj ten URL, aby użyć go jako Webhook, przykładowy URL to https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1. Następnie możemy ustawić pole callback_url na powyższy URL Webhook, a także wypełnić odpowiednie parametry, szczegóły jak na obrazku:

Klikając uruchom, można zauważyć, że natychmiast otrzymujemy wynik, jak poniżej:

{
  "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad"
}

Po chwili możemy na https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1 zobaczyć wynik generacji zadania, jak pokazano na obrazku:

Treść wygląda następująco:

{
    "success": true,
    "task_id": "1a6ac2ad-10f2-4e2b-b500-66ec27fe82ad",
    "trace_id": "1da03537-4eb8-410d-b849-43f03085a3bb",
    "data": [
        {
            "id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "title": "Obudziłem się z słońcem w oczach",
            "image_url": "https://cdn.acedata.cloud/e724d7f13d.png",
            "lyric": "[Zwrotka]\nObudziłem się z słońcem w oczach\nBrak chmur, tylko niebieskie niebo\nButy na nogach, jestem gotowy do biegu\nKażdy krok czuje się jak załadowany pistolet\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nBrak cieni, brak kłamstw\nTylko prawda, która mnie unosi\n[Zwrotka 2]\nTańcząc przez ulice miasta\nRytm bije w moim sercu\nObcy się uśmiechają, to się zaraża\nTen świat to scena, wszyscy jesteśmy piosenką\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nBrak cieni, brak kłamstw\nTylko prawda, która mnie unosi\n[Most]\nWyrzuć swoje zmartwienia za drzwi\nNiech zatoną na dnie oceanu\nJesteśmy żywi i to wystarczy\nŻycie jest chaotyczne, ale to miłość\n[Refren]\nSzczęśliwe dni nadchodzą\nNiech radość pod moją skórą\nBrak cieni, brak kłamstw\nTylko prawda, która mnie unosi",
            "audio_url": "https://platform2.cdn.acedata.cloud/fish/5ade0339-5f11-487e-aacc-06a908271706.mp3",
            "video_url": null,
            "image_id": "1dd08826-478e-43a6-868f-aff5ababac2c",
            "topic": null,
            "seed": "1490770667",
            "sound": "",
            "created_at": "2025-12-30T18:36:00.994141Z",
            "model": "FUZZ-2.0 Pro",
            "progress": "100%",
            "state": "succeeded",
            "duration": "135.2330158730159"
        }
    ]
}

Można zobaczyć, że w wyniku znajduje się pole task_id, a inne pola są podobne do powyższych, dzięki czemu można powiązać zadania.

Obsługa błędów

Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informacje. Na przykład:

400 token_mismatched: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
400 api_not_implemented: Złe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów.
401 invalid_token: Nieautoryzowany, nieprawidłowy lub brakujący token autoryzacyjny.
429 too_many_requests: Zbyt wiele żądań, przekroczyłeś limit szybkości.
500 api_error: Błąd wewnętrzny serwera, coś poszło nie tak na serwerze.

Przykład odpowiedzi błędu

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "pobieranie nie powiodło się"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Wnioski

Dzięki temu dokumentowi zrozumiałeś, jak korzystać z API Generacji Dźwięków Producenta, aby generować muzykę na podstawie wprowadzonych słów kluczowych. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i korzystać z tego API. W razie jakichkolwiek pytań, skontaktuj się z naszym zespołem wsparcia technicznego.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Proxy

Advanced

Coding

Producent Audios Generation API - instrukcja integracji

Proces aplikacji

Podstawowe użycie

Niestandardowe generowanie

Przykład coveru piosenki

Kontynuacja piosenki

Muzyczna transformacja

Zastąpienie fragmentu

Przeróbka podkładu

Przeróbka wokalu

Oddzielanie tekstu od muzyki

Asynchroniczne wywołanie zwrotne

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikacji

​Podstawowe użycie

​Niestandardowe generowanie

​Przykład coveru piosenki

​Kontynuacja piosenki

​Muzyczna transformacja

​Zastąpienie fragmentu

​Przeróbka podkładu

​Przeróbka wokalu

​Oddzielanie tekstu od muzyki

​Asynchroniczne wywołanie zwrotne

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikacji

Podstawowe użycie

Niestandardowe generowanie

Przykład coveru piosenki

Kontynuacja piosenki

Muzyczna transformacja

Zastąpienie fragmentu

Przeróbka podkładu

Przeróbka wokalu

Oddzielanie tekstu od muzyki

Asynchroniczne wywołanie zwrotne

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski