> ## Documentation Index > Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Integracja i korzystanie z Suno Tasks API > Suno Music Generation API guide - Ace Data Cloud Główną funkcją Suno Tasks API jest sprawdzanie stanu wykonania zadania poprzez wprowadzenie ID zadania wygenerowanego przez Suno Audios Generation API lub Suno Lyrics Generation API. Ten dokument szczegółowo przedstawi instrukcje integracji Suno Tasks API, aby pomóc Ci łatwo zintegrować i w pełni wykorzystać potężne możliwości tego API. Za pomocą Suno Tasks API możesz łatwo realizować sprawdzanie stanu wykonania zadań Suno Lyrics Generation API lub Suno Audios Generation API. ## Proces aplikowania Aby korzystać z Suno Audios Generation API, najpierw przejdź do [konsoli Ace Data Cloud](https://platform.acedata.cloud/console/applications), aby uzyskać swój API Token i zachować go na później. ![](https://cdn.acedata.cloud/dvc3cg.jpg) Jeśli nie jesteś jeszcze zalogowany ani zarejestrowany, zostaniesz automatycznie przekierowany na stronę logowania, która zaprosi Cię do rejestracji i zalogowania się, a po zakończeniu automatycznie powrócisz na bieżącą stronę. **Jeden API Token umożliwia wywoływanie wszystkich usług platformy, nie ma potrzeby osobnego aplikowania dla każdej usługi.** Przy pierwszej aplikacji otrzymasz bezpłatny limit, który pozwala na darmowe wypróbowanie; gdy limit jest niewystarczający, możesz doładować wspólne saldo w [konsoli](https://platform.acedata.cloud/console/coin). > 📘 Pełna dokumentacja: [Suno Audios Generation API →](https://platform.acedata.cloud/documents/suno-audios) ## Przykład żądania Suno Tasks API może być używane do sprawdzania wyników dwóch API: Suno Audios Generation API i Suno Lyrics Generation API. Informacje o tym, jak korzystać z Suno Audios Generation API, znajdziesz w dokumentacji [Suno Audios Generation API ](https://platform.acedata.cloud/documents/suno-audios-integration). Informacje o tym, jak korzystać z Suno Lyrics Generation API, znajdziesz w [Suno Lyrics Generation API ](https://platform.acedata.cloud/documents/suno-lyrics-generation-integration). Jako przykład weźmiemy jedno ID zadania zwrócone przez usługę Suno Audios Generation API, aby zademonstrować, jak korzystać z tego API. Załóżmy, że mamy ID zadania: eae26f89-b64b-404d-a80c-761996660b1c, następnie zademonstrujemy, jak poprzez przekazanie jednego ID zadania. ### Grafika przykładowego zadania ![](https://cdn.acedata.cloud/bc6754.png) ### Ustawianie nagłówków żądania i treści żądania **Request Headers** obejmują: * `accept`: określa odbieranie wyników odpowiedzi w formacie JSON, tutaj wpisz `application/json`. * `authorization`: klucz do wywołania API, po aplikowaniu można go bezpośrednio wybrać z listy rozwijanej. **Request Body** obejmuje: * `id`: ID przesłanego zadania. * `action`: sposób operacji na zadaniu. Ustawienia są pokazane na poniższym obrazku: ![](https://cdn.acedata.cloud/uo7t6n.png) ### Przykład kodu Można zauważyć, że po prawej stronie strony automatycznie wygenerowano już kod w różnych językach, jak pokazano na obrazku: ![](https://cdn.acedata.cloud/p6vi9o.png) Część przykładów kodu jest następująca: #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/suno/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "id": "eae26f89-b64b-404d-a80c-761996660b1c", "action": "retrieve" }' ``` #### Python ```python theme={null} import requests url = "https://api.acedata.cloud/suno/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "id": "eae26f89-b64b-404d-a80c-761996660b1c", "action": "retrieve" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ### Przykład odpowiedzi Po pomyślnym żądaniu API zwróci szczegółowe informacje o zadaniu utworu tutaj. Na przykład: ```json theme={null} { "_id": "66d2add5550a4144a5a88dfe", "id": "eae26f89-b64b-404d-a80c-761996660b1c", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083093.077, "started_at": 1725083093.137, "finished_at": 1725083131.537, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "generate", "prompt": "A song for Christmas" }, "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "eae26f89-b64b-404d-a80c-761996660b1c", "data": [ { "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e", "title": "Holiday Wishes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "A song for Christmas", "style": "pop", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Holiday Wishes", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Verse]\nSnow is falling soft and white\nLights are twinkling oh so bright\nKids are laughing full of cheer\nChristmas time is finally here\n[Verse 2]\nBells are ringing in the night\nFireplace is warm with light\nCarols sung by the tree\nEveryone's together we agree\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Verse 3]\nGifts are wrapped with loving care\nMagic's floating in the air\nCookies baking in the oven\nChristmas love to be given\n[Chorus]\nHoliday wishes come true\nTime to share the joy with you\nSmiles and hugs for everyone\nMerry Christmas let's have fun\n[Bridge]\nStars are shining in the sky\nHold your loved ones don't ask why\nHeart to heart we're all united\nOn this night we are delighted", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "A song for Christmas", "style": "pop", "duration": 147.16 } ] } } ``` Zwrócony wynik zawiera wiele pól, pole `request` jest request body podczas inicjowania zadania, natomiast pole `response` jest response body zwracanym po ukończeniu zadania. Opis pól jest następujący. * `id`, ID zadania generowania tej piosenki, używane do jednoznacznej identyfikacji tego zadania generowania piosenki. * `request`, informacje o żądaniu w zapytaniu o zadanie piosenki. * `response`, informacje zwrotne w zapytaniu o zadanie piosenki. * `created_at`, czas utworzenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). * `started_at`, czas rozpoczęcia wykonywania zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). * `finished_at`, czas ukończenia zadania, znacznik czasu Unix (sekundy, liczba zmiennoprzecinkowa). To pole nie jest zwracane, gdy zadanie nie zostało ukończone. * `elapsed`, czas wykonywania zadania, w sekundach (liczba zmiennoprzecinkowa, zachowane 3 miejsca po przecinku). To pole nie jest zwracane, gdy zadanie nie zostało ukończone. ## Operacja zapytania zbiorczego Jest to zapytanie o szczegóły zadań piosenek dla wielu ID zadań. Różnica w porównaniu z powyższym polega na tym, że należy wybrać action jako retrieve\_batch **Request Body** obejmuje: * `ids`: przesłana tablica ID zadań. * `action`: sposób operacji na zadaniu. Ustawienia są pokazane na poniższym obrazku: ![](https://cdn.acedata.cloud/dqeknz.png) ### Przykład kodu Można zauważyć, że po prawej stronie strony automatycznie wygenerowano już kod w różnych językach, jak pokazano na obrazku: ![](https://cdn.acedata.cloud/1yk792.png) Częściowe przykłady kodu są następujące: ### Przykład odpowiedzi Po pomyślnym wykonaniu żądania API zwróci szczegółowe informacje o wszystkich zadaniach piosenek w tej partii. Na przykład: ```json { theme={null} "items": [ { "_id": "66d2add5550a4144a5a88dfe", "id": "eae26f89-b64b-404d-a80c-761996660b1c", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083093.077, "started_at": 1725083093.137, "finished_at": 1725083131.537, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "generate", "prompt": "A song for Christmas" }, "trace_id": "e13d385a-077e-4376-be01-3465b61ca0fd", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "eae26f89-b64b-404d-a80c-761996660b1c", "data": [ { "id": "b8a4f691-4b14-4120-a7e1-a54a27a0e57e", "title": "Świąteczne życzenia", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Zwrotka]\nŚnieg pada miękko i biało\nŚwiatła migoczą och tak jasno\nDzieci śmieją się pełne radości\nCzas Bożego Narodzenia wreszcie nadszedł\n[Zwrotka 2]\nDzwony dzwonią w nocy\nKominek jest ciepły od światła\nKolędy śpiewane przy drzewku\nWszyscy są razem, zgadzamy się\n[Refren]\nŚwiąteczne życzenia się spełniają\nCzas dzielić radość z tobą\nUśmiechy i uściski dla każdego\nWesołych Świąt, bawmy się\n[Zwrotka 3]\nPrezenty są zapakowane z troskliwą miłością\nMagia unosi się w powietrzu\nCiasteczka pieką się w piekarniku\nBożonarodzeniowa miłość do ofiarowania\n[Refren]\nŚwiąteczne życzenia się spełniają\nCzas dzielić radość z tobą\nUśmiechy i uściski dla każdego\nWesołych Świąt, bawmy się\n[Most]\nGwiazdy świecą na niebie\nPrzytul swoich bliskich, nie pytaj dlaczego\nSerce przy sercu wszyscy jesteśmy zjednoczeni\nTej nocy jesteśmy zachwyceni", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "Piosenka na Boże Narodzenie", "style": "pop", "duration": 154.44 }, { "id": "1a3343b2-2c24-4584-a2a7-687e2f97f09e", "title": "Świąteczne życzenia", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Zwrotka]\nŚnieg pada miękko i biało\nŚwiatła migoczą och tak jasno\nDzieci śmieją się pełne radości\nCzas Bożego Narodzenia wreszcie nadszedł\n[Zwrotka 2]\nDzwony dzwonią w nocy\nKominek jest ciepły od światła\nKolędy śpiewane przy drzewku\nWszyscy są razem, zgadzamy się\n[Refren]\nŚwiąteczne życzenia się spełniają\nCzas dzielić radość z tobą\nUśmiechy i uściski dla każdego\nWesołych Świąt, bawmy się\n[Zwrotka 3]\nPrezenty są zapakowane z troskliwą miłością\nMagia unosi się w powietrzu\nCiasteczka pieką się w piekarniku\nBożonarodzeniowa miłość do ofiarowania\n[Refren]\nŚwiąteczne życzenia się spełniają\nCzas dzielić radość z tobą\nUśmiechy i uściski dla każdego\nWesołych Świąt, bawmy się\n[Most]\nGwiazdy świecą na niebie\nPrzytul swoich bliskich, nie pytaj dlaczego\nSerce przy sercu wszyscy jesteśmy zjednoczeni\nTej nocy jesteśmy zachwyceni", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:44:54.806Z", "model": "chirp-v3.5", "prompt": "Piosenka na Boże Narodzenie", "style": "pop", "duration": 147.16 } ] } }, { "_id": "66d2b03c550a4144a5a8d93d", "id": "0d3ed03b-912b-4f7d-941b-8441323cb77b", "api_id": "09a26295-5972-4392-9318-dcd9b218f90d", "application_id": "ab46a066-ad82-4180-b66b-49dedf8e8a2f", "created_at": 1725083708.53, "started_at": 1725083708.59, "finished_at": 1725083746.99, "elapsed": 38.4, "credential_id": "66614a7e-e624-494e-87a3-387099b8cbb4", "request": { "action": "generuj", "prompt": "la la la" }, "trace_id": "29ebb919-1126-4156-86cc-4ad899432a8c", "user_id": "ad7afe47-cea9-4cda-980f-2ad8810e51cf", "response": { "success": true, "task_id": "0d3ed03b-912b-4f7d-941b-8441323cb77b", "data": [ { "id": "b4f498b2-e86f-4172-926a-39da9df84dd3", "title": "La La La", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Zwrotka]\nBudzę się każdego ranka\nPatrzę przez okno\nJasno świecące światło słońca\nPoczątek nowego dnia\n[Zwrotka 2]\nPtaki śpiewają radośnie\nTańczę w ogrodzie\nOtaczają mnie piękne kwiaty\nKażda chwila jest moja\n[Refren]\nLa la la la la la\nŚpiewaj ze mną\nNie przestawaj\nLa la la la la la\nRaduj się, ciesząc się życiem\n[Zwrotka 3]\nMorze błękitne i rozległe\nFale łagodnie przypływają\nSpacerujemy po plażach\nNiezależnie od czasu\n[Most]\nChwytaj każdą godzinę\nSłuchaj moich pieśni\nPoczuj się wolny\nSzczęśliwy\nTańcz teraz w rytmie\n[Refren]\nLa la la la la la\nŚpiewaj ze mną\nNie przestawaj\nLa la la la la la\nRaduj się, ciesząc się życiem", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:55:09.345Z", "model": "chirp-v3.5", "prompt": "la la la", "style": "pop", "duration": 154.32 }, { "id": "8b44fdf1-3b88-47ac-a351-7c4b4de60549", "title": "La La La", "image_url": "https://cdn.acedata.cloud/e724d7f13d.png", "lyric": "[Zwrotka]\nBudzę się każdego ranka\nPatrzę przez okno\nJasno świecące światło słoneczne\nPoczątek nowego dnia\n[Zwrotka 2]\nPtaki śpiewają radośnie\nTańczę w ogrodzie\nOtaczają mnie piękne kwiaty\nKażda ta chwila jest moja\n[Refren]\nLa la la la la la\nŚpiewaj ze mną\nNie zatrzymuj się\nLa la la la la la\nRaduj się, ciesząc się życiem\n[Zwrotka 3]\nMorze błękitne i rozległe\nFale łagodnie przypływają\nSpacerujemy po plażach\nNiezależnie od pogody\n[Bridge]\nChwytaj każdą godzinę\nSłuchaj mojego śpiewu\nPoczuj się wolny\nSzczęśliwy\nTańcz teraz w rytmie\n[Refren]\nLa la la la la la\nŚpiewaj ze mną\nNie zatrzymuj się\nLa la la la la la\nRaduj się, ciesząc się życiem", "audio_url": "https://cdn.acedata.cloud/assets/examples/fish/5ade0339-5f11-487e-aacc-06a908271706-8e3fcb0e5547.mp3", "video_url": "https://cdn.acedata.cloud/assets/examples/gemini/04a043bd-6b23-4b4e-945c-ce48158c3eee-3a89912507c7.mp4", "created_at": "2024-08-31T05:55:09.345Z", "model": "chirp-v3.5", "prompt": "la la la", "style": "pop", "duration": 177.36 } ] } } ], "count": 2 } ``` Wynik zwracany zawiera wiele pól, z których `items` zawiera szczegółowe informacje o zadaniach wsadowych utworów, a szczegółowe informacje o każdym zadaniu utworu są takie same jak pola powyżej. Informacje o polach są następujące. * `items`, wszystkie szczegółowe informacje o zadaniach wsadowych utworów. Jest to tablica, a każdy element tablicy ma taki sam format jak wynik zwracany podczas zapytania o pojedyncze zadanie powyżej. * `count`, liczba zadań utworów w tym wsadowym zapytaniu. #### CURL ```bash theme={null} curl -X POST 'https://api.acedata.cloud/suno/tasks' \ -H 'accept: application/json' \ -H 'authorization: Bearer {token}' \ -H 'content-type: application/json' \ -d '{ "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"], "action": "retrieve_batch" }' ``` #### Python ```python theme={null} import requests url = "https://api.acedata.cloud/suno/tasks" headers = { "accept": "application/json", "authorization": "Bearer {token}", "content-type": "application/json" } payload = { "ids": ["eae26f89-b64b-404d-a80c-761996660b1c","0d3ed03b-912b-4f7d-941b-8441323cb77b"], "action": "retrieve_batch" } response = requests.post(url, json=payload, headers=headers) print(response.text) ``` ## Obsługa błędów Podczas wywoływania API, jeśli wystąpi błąd, API zwróci odpowiedni kod błędu i informację. Na przykład: * `400 token_mismatched`: Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów. * `400 api_not_implemented`: Nieprawidłowe żądanie, prawdopodobnie z powodu brakujących lub nieprawidłowych parametrów. * `401 invalid_token`: Brak autoryzacji, nieprawidłowy lub brakujący token autoryzacyjny. * `429 too_many_requests`: Zbyt wiele żądań, przekroczono limit częstotliwości. * `500 api_error`: Wewnętrzny błąd serwera, coś poszło nie tak na serwerze. ### Przykład odpowiedzi błędu ```json theme={null} { "success": false, "error": { "code": "api_error", "message": "fetch failed" }, "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89" } ``` ## Wnioski Dzięki temu dokumentowi dowiedziałeś się, jak używać Suno Tasks API do wyszukiwania wszystkich szczegółowych informacji o pojedynczych lub wsadowych zadaniach utworów. Mamy nadzieję, że ten dokument pomoże Ci lepiej zintegrować i używać tego API. W razie jakichkolwiek pytań prosimy o kontakt z naszym zespołem wsparcia technicznego. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.