Zum Hauptinhalt springen

Einführung

Producer ist ein von Ace Data Cloud angebotener KI-Audioservice, FUZZ Producer AI Musikgenerierung. Über die einheitliche API von Ace Data Cloud können Sie mit cURL schnell Producer aufrufen, um Funktionen wie Text-zu-Musik-Generierung, benutzerdefinierte Songtexte, Songfortsetzung, Coverversionen, Gesangstrennung, MV-Erstellung und mehr zu realisieren.

Voraussetzungen

  • Ein Konto bei Ace Data Cloud besitzen und einen API-Token erhalten
  • Ein Terminal mit installiertem cURL

Grundlegende Verwendung

Der Hauptendpunkt für den Aufruf der Producer API lautet:
POST https://api.acedata.cloud/producer/audios
In diesem Beispiel wird das Modell FUZZ-2.0 Pro verwendet. Verfügbare Modelle sind: FUZZ-2.0 Pro, FUZZ-2.0, FUZZ-1.1 Pro, FUZZ-1.0 Pro. Vollständiges cURL-Beispiel:
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}'
Bitte ersetzen Sie YOUR_API_TOKEN durch den tatsächlichen Token, den Sie auf der Ace Data Cloud Plattform erhalten haben.

Beispielantwort

Bei erfolgreichem Aufruf wird eine JSON-Antwort zurückgegeben, z.B.:
{
  "status": "success",
  "data": {
    ...
  }
}

Verarbeitung der Antwort mit jq

Es wird empfohlen, das Tool jq zur Formatierung der Ausgabe zu verwenden:
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 .

Fehlerbehandlung

Häufige Fehlercodes:
StatuscodeBeschreibung
401Authentifizierung fehlgeschlagen, bitte API-Token prüfen
403Unzureichendes Guthaben oder kein Zugriff
429Anfragerate überschritten
500Interner Serverfehler

Nächste Schritte