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 zintegrować Producer w Pythonie, 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

  • Konto w Ace Data Cloud oraz uzyskany API Token
  • Środowisko Python 3.7 lub nowsze
  • Zainstalowana biblioteka requests: pip install requests

​
Podstawowe użycie

Główny endpoint API Producer to: 
POST https://api.acedata.cloud/producer/audios
W tym przykładzie używamy modelu 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 kodu w Python: 
import requests

url = "https://api.acedata.cloud/producer/audios"
headers = {
    "Authorization": "Bearer YOUR_API_TOKEN",
    "Content-Type": "application/json"
}
data = {
    "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
}

response = requests.post(url, headers=headers, json=data)
result = response.json()
print(result)
Zamień YOUR_API_TOKEN na rzeczywisty Token uzyskany na platformie Ace Data Cloud.

​
Obsługa odpowiedzi

Po pomyślnym wywołaniu API zwraca dane w formacie JSON. Zaleca się sprawdzenie kodu statusu HTTP: 
if response.status_code == 200:
    result = response.json()
    print("Wywołanie zakończone sukcesem:", result)
else:
    print(f"Wywołanie nie powiodło się, kod statusu: {response.status_code}")
    print(response.text)

​
Zaawansowane użycie

Dla API obsługujących zadania asynchroniczne można uzyskać wynik przez callback URL: 
data['callback_url'] = 'https://your-server.com/callback'
response = requests.post(url, headers=headers, json=data)
# Wynik zostanie przesłany na Twój serwer przez callback URL

​
Obsługa błędów

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

​
Inne endpointy

Usługa Producer oferuje również następujące endpointy:
  • POST https://api.acedata.cloud/producer/videos
  • POST https://api.acedata.cloud/producer/wav
  • POST https://api.acedata.cloud/producer/tasks
  • POST https://api.acedata.cloud/producer/lyrics

​
Kolejne kroki