Przejdź do głównej treści

Wprowadzenie

Producer to usługa AI audio oferowana przez Ace Data Cloud, FUZZ Producer AI generowanie muzyki. Dzięki zunifikowanemu API Ace Data Cloud możesz szybko wywoływać Producer za pomocą cURL, realizując funkcje takie jak generowanie muzyki na podstawie tekstu, niestandardowe teksty piosenek, kontynuacja utworów, covery, separacja wokalu, generowanie teledysków i inne.

Wymagania wstępne

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

Podstawowe użycie

Główny endpoint API Producer to:
POST https://api.acedata.cloud/producer/audios
W tym przykładzie używany jest model FUZZ-2.0 Pro. Dostępne modele to: FUZZ-2.0 Pro, FUZZ-2.0, FUZZ-1.1 Pro, FUZZ-1.0 Pro. Pełny przykład polecenia cURL:
curl -X POST https://api.acedata.cloud/producer/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A relaxing jazz piece for a coffee shop", "model": "FUZZ-2.0 Pro", "lyric": "[Verse]\nSoft piano keys in the morning light", "custom": true}'
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/producer/audios \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"action": "generate", "prompt": "A relaxing jazz piece for a coffee shop", "model": "FUZZ-2.0 Pro", "lyric": "[Verse]\nSoft piano keys in the morning light", "custom": true}' | jq .

Obsługa błędów

Typowe kody błędów:
Kod statusuOpis
401Błąd uwierzytelniania, sprawdź token API
403Niewystarczające środki lub brak dostępu
429Przekroczona częstotliwość żądań
500Błąd wewnętrzny serwera

Kolejne kroki