Integracja i korzystanie z Suno Tasks API

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, aby uzyskać swój API Token i zachować go na później.

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.

📘 Pełna dokumentacja: Suno Audios Generation API →

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 . Informacje o tym, jak korzystać z Suno Lyrics Generation API, znajdziesz w Suno Lyrics Generation API . 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

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:

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:

Część przykładów kodu jest następująca:

CURL

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

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:

{
  "_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:

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:

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:

  "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

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

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

{
  "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.

Getting Started

Czat AI

Obraz AI

Wideo AI

Audio AI

Sieć i dane

CAPTCHA

Tożsamość

Coding

Więcej przewodników

Integracja i korzystanie z Suno Tasks API

Proces aplikowania

Przykład żądania

Grafika przykładowego zadania

Ustawianie nagłówków żądania i treści żądania

Przykład kodu

CURL

Python

Przykład odpowiedzi

Operacja zapytania zbiorczego

Przykład kodu

Przykład odpowiedzi

CURL

Python

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski

​Proces aplikowania

​Przykład żądania

​Grafika przykładowego zadania

​Ustawianie nagłówków żądania i treści żądania

​Przykład kodu

​CURL

​Python

​Przykład odpowiedzi

​Operacja zapytania zbiorczego

​Przykład kodu

​Przykład odpowiedzi

​CURL

​Python

​Obsługa błędów

​Przykład odpowiedzi błędu

​Wnioski

Proces aplikowania

Przykład żądania

Grafika przykładowego zadania

Ustawianie nagłówków żądania i treści żądania

Przykład kodu

CURL

Python

Przykład odpowiedzi

Operacja zapytania zbiorczego

Przykład kodu

Przykład odpowiedzi

CURL

Python

Obsługa błędów

Przykład odpowiedzi błędu

Wnioski