Przejdź do głównej treści

Wprowadzenie

Suno to usługa AI audio oferowana przez Ace Data Cloud, generująca muzykę AI Suno. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywołać Suno za pomocą cURL, realizując funkcje takie jak generowanie muzyki z tekstu, niestandardowe teksty piosenek, kontynuacja utworów, covery, separacja wokalu, generowanie tekstów piosenek i inne.

Wymagania wstępne

  • Posiadanie konta w Ace Data Cloud oraz uzyskanie tokenu API
  • Środowisko terminalowe z zainstalowanym cURL

Podstawowe użycie

Główny endpoint API Suno to:
POST https://api.acedata.cloud/suno/audios
W tym przykładzie używany jest model chirp-v5. Dostępne modele to: chirp-v5, v4-5-plus, v4-5, v4, v3-5. Pełny przykład polecenia cURL:
curl -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A cheerful pop song about summer vacation", "model": "chirp-v5", "custom": false}'
Zamień YOUR_API_TOKEN na rzeczywisty token uzyskany na platformie Ace Data Cloud.

Przykład odpowiedzi

Po pomyślnym wywołaniu zwracane są dane w formacie JSON, na przykład:
{
  "status": "success",
  "data": {
    ...
  }
}

Przetwarzanie odpowiedzi za pomocą jq

Zaleca się użycie narzędzia jq do formatowania wyjścia:
curl -s -X POST https://api.acedata.cloud/suno/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A cheerful pop song about summer vacation", "model": "chirp-v5", "custom": false}' | jq .

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Nieudana autoryzacja, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczono limit częstotliwości żądań
500Wewnętrzny błąd serwera

Kolejne kroki