Antragsprozess
Um die API zu nutzen, müssen Sie zunächst auf die entsprechende Seite der Producer Audios Generation API gehen und den entsprechenden Dienst beantragen. Nach dem Betreten der Seite klicken Sie auf die Schaltfläche „Acquire“, wie im Bild gezeigt:
Wenn Sie noch nicht angemeldet oder registriert sind, werden Sie automatisch zur Anmeldeseite weitergeleitet, um sich zu registrieren und anzumelden. Nach der Anmeldung werden Sie automatisch zur aktuellen Seite zurückgeleitet.
Bei der ersten Antragstellung gibt es ein kostenloses Kontingent, mit dem Sie die API kostenlos nutzen können.
Grundlegende Nutzung
Wenn Sie an bestimmten Songs denken, können Sie beliebigen Text eingeben. Wenn ich zum Beispiel ein Lied über Weihnachten generieren möchte, kann icha song for Christmas eingeben, wie im Bild gezeigt:
accept: In welchem Format Sie die Antwort erhalten möchten, hier eingetragen alsapplication/json, also im JSON-Format.authorization: Der Schlüssel zur Nutzung der API, den Sie nach der Beantragung direkt auswählen können.
action: Die Aktion dieser Musikgenerierungsaufgabe, um ein Lied zu generieren, istgenerate.model: Das Modell, das zur Erstellung des Songs verwendet wird, derzeit hauptsächlich: FUZZ-2.0 Pro, FUZZ-2.0, FUZZ-2.0 Raw, FUZZ-1.1 Pro, FUZZ-1.0 Pro, FUZZ-1.0, FUZZ-1.1, FUZZ-0.8.lyric: Der Text des Liedes.custom: Ob die benutzerdefinierte Methode zur Generierung des Songs verwendet werden soll.prompt: Stichworte im Inspirationsmodus.title: Informationen zum Titel des Songs.audio_id: Referenz-Song-ID, die für Fortsetzungen/Remakes usw. verwendet wird.continue_at: Fortsetzung des Songs ab einer bestimmten Sekunde.replace_section_start/replace_section_end: Start- und Endzeit des zu ersetzenden Abschnitts, in Sekunden.lyrics_strength: Die Stärke der Lyrics, die den Einfluss der Lyrics auf die Audioerzeugung angibt, wählbar zwischen 0-1, Standardwert 0.7.sound_strength: Die Stärke der Audio-Stichworte, wählbar zwischen 0.2-1, Standardwert 0.7.cover_strength: Die Stärke des Covers, wählbar zwischen 0.2-1, Standardwert 1.weirdness: Der Grad der Stilbesonderheit, wählbar zwischen 0-1, Standardwert 0.5.callback_url: Die URL, an die die Ergebnisse zurückgegeben werden sollen.instrumental: Ob es sich um einen instrumentalen Modus ohne Lyrics handelt.
success, der Status der Musikgenerierungsaufgabe zu diesem Zeitpunkt.data, das Ergebnis dieser Musikaufgabeid, die ID der Musikgenerierungsaufgabe zu diesem Zeitpunkt.sound, das Stichwort der Musikgenerierungsaufgabe zu diesem Zeitpunkt.seed, der Seed-Wert der Musikgenerierungsaufgabe zu diesem Zeitpunkt.audio_url, der Audio-Link der Musikgenerierungsaufgabe zu diesem Zeitpunkt.image_url, der Cover-Link der Musikgenerierungsaufgabe zu diesem Zeitpunkt.image_id, die Cover-ID der Musikgenerierungsaufgabe zu diesem Zeitpunkt.state, der Status der Musikgenerierungsaufgabe zu diesem Zeitpunkt.duration, die Dauer der Musik zu diesem Zeitpunkt.progress, der Fortschrittswert der Musikaufgabe zu diesem Zeitpunkt.model, die Modellinformationen, die für die Musikgenerierungsaufgabe verwendet werden.lyric, die Lyrics-Informationen der Musikgenerierungsaufgabe zu diesem Zeitpunkt.
data verwenden, um die generierte Producer-Musik abzurufen.
Wenn Sie den entsprechenden Integrationscode generieren möchten, können Sie ihn direkt kopieren, zum Beispiel sieht der CURL-Code wie folgt aus:
Benutzerdefinierte Generierung
Wenn Sie benutzerdefinierte Lyrics generieren möchten, können Sie die Lyrics eingeben: In diesem Fall kann daslyric-Feld Inhalte wie folgt übergeben:
- lyric: Text der Lyrics
- custom: auf
truesetzen, was bedeutet, dass eine benutzerdefinierte Generierung erfolgt. Dieser Parameter ist standardmäßig auf false gesetzt, was bedeutet, dasspromptverwendet wird. - title: Der Titel des Songs. 填写样例如下：
翻唱歌曲
Wenn Sie die bereits generierte Musik covern möchten, können Sie den oben generierten Song eingeben, um ihn zu covern. Als nächstes müssen wir basierend auf den Lyrics und dem Titel einen Song anpassen. Wenn Sie einen selbst hochgeladenen Song weiter covern möchten, können Sie den Parameteraction auf upload_cover setzen und die ID des Songs eingeben, den Sie weiter covern möchten. Die Song-ID kann über die Producer Upload API abgerufen werden, wie im folgenden Bild gezeigt:
- action: Die Aktion für diese Songaufgabe, derzeit unterstützt: generate, cover, extend, upload_cover, upload_extend, replace_section, swap_vocals, swap_instrumentals, variation, für dieses Cover verwenden Sie den Parameter
cover. - lyric: Text der Lyrics
- title: Der Titel des Songs.
- custom: Ob der benutzerdefinierte Modus verwendet werden soll, standardmäßig ist es false.
- audio_id: Die ID des Songs, den Sie covern möchten.
Fortsetzung des Songs
Wenn Sie den Song fortsetzen möchten, müssen wir denaction-Parameterwert auf: extend setzen, und dann müssen wir basierend auf den Texten, dem Titel und dem Stil den Song anpassen.
Wenn Sie den von Ihnen hochgeladenen Song fortsetzen möchten, können Sie den Parameter action auf upload_extend setzen und die ID des Songs eingeben, den Sie fortsetzen möchten. Die Song-ID kann mit der Producer Upload API abgerufen werden, wie im folgenden Bild gezeigt:
Musikvariation
Wenn Sie basierend auf dem Seed-Wert des vorherigen Songs eine neue Musik mit ähnlichem Effekt generieren möchten, müssen wir denaction-Parameterwert auf: variation setzen, und dann können wir eine neue Musik mit ähnlichem Effekt anpassen.
Das Beispiel zum Ausfüllen sieht wie folgt aus:
Ersetzen von Abschnitten
Wenn Sie einen Abschnitt des Songs ersetzen möchten, müssen wir den Parameteraction mit dem Wert: replace_section übergeben, anschließend müssen wir basierend auf den Lyrics und dem Titel den Song anpassen.
Wenn Sie einen von Ihnen hochgeladenen Song weiterhin ersetzen möchten, können Sie den Parameter action auf upload_replace_section setzen und die ID des Songs eingeben, den Sie weiter anpassen möchten. Die Song-ID kann über die Producer Upload API abgerufen werden, wie im folgenden Bild gezeigt:
Begleitmusik-Umwandlung
Wenn Sie die offizielle Begleitmusik-Umwandlung verwenden möchten, können Sie den Wert desaction-Parameters auf swap_instrumentals setzen, und dann werden wir basierend auf den Texten und dem Titel ein Lied generieren.
Das ausgefüllte Beispiel sieht wie folgt aus:
Gesangsumwandlung
Wenn Sie die offizielle Gesangsumwandlung verwenden möchten, können Sie den Wert desaction-Parameters auf swap_vocals setzen, und dann werden wir basierend auf den Texten, dem Titel und dem Stil ein Lied generieren.
Das ausgefüllte Beispiel sieht wie folgt aus:
Wort- und Musiktrennung
Wenn Sie die offizielle Wort- und Musiktrennung verwenden möchten, können Sie den Wert des Parametersaction auf: stems setzen, und dann müssen wir die Wort- und Musiktrennung basierend auf der Song-ID durchführen.
Das Beispiel ist wie folgt:
Asynchrone Rückrufe
Da die von der Producer Audios Generation API erzeugte Zeit manchmal relativ lang sein kann, wird die HTTP-Anfrage bei langer Nichtreaktion der API die Verbindung aufrechterhalten, was zu einem zusätzlichen Systemressourcenverbrauch führt. Daher bietet diese API auch Unterstützung für asynchrone Rückrufe. Der gesamte Prozess ist: Wenn der Client die Anfrage stellt, gibt er zusätzlich ein Feldcallback_url an. Nachdem der Client die API-Anfrage gestellt hat, gibt die API sofort ein Ergebnis zurück, das ein Feld task_id enthält, das die aktuelle Aufgaben-ID darstellt. Wenn die Aufgabe abgeschlossen ist, wird das Ergebnis der Generierung der Aufgabe in Form von POST JSON an die vom Client angegebene callback_url gesendet, wobei auch das Feld task_id enthalten ist, sodass das Aufgabenergebnis über die ID verknüpft werden kann.
Lassen Sie uns anhand eines Beispiels verstehen, wie dies konkret funktioniert.
Zunächst ist der Webhook-Rückruf ein Dienst, der HTTP-Anfragen empfangen kann. Entwickler sollten ihn durch die URL ihres eigenen HTTP-Servers ersetzen. Hier zur Veranschaulichung verwenden wir eine öffentliche Webhook-Beispielwebsite https://webhook.site/, die beim Öffnen der Website eine Webhook-URL bereitstellt, wie im Bild gezeigt:
Kopieren Sie diese URL, um sie als Webhook zu verwenden. Das Beispiel hier ist https://webhook.site/#!/view/0d73431d-f833-4be4-9276-b6e1690d55c1.
Als nächstes können wir das Feld callback_url auf die oben genannte Webhook-URL setzen und die entsprechenden Parameter ausfüllen, wie im Bild gezeigt:
Der Inhalt ist wie folgt:
task_id-Feld enthält, die anderen Felder sind ähnlich wie oben erwähnt, und über dieses Feld kann die Aufgabe zugeordnet werden.
Fehlerbehandlung
Beim Aufruf der API, wenn ein Fehler auftritt, gibt die API den entsprechenden Fehlercode und die Informationen zurück. Zum Beispiel:400 token_mismatched: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.400 api_not_implemented: Ungültige Anfrage, möglicherweise aufgrund fehlender oder ungültiger Parameter.401 invalid_token: Unbefugt, ungültiger oder fehlender Autorisierungstoken.429 too_many_requests: Zu viele Anfragen, Sie haben das Kontingent überschritten.500 api_error: Interner Serverfehler, etwas ist auf dem Server schiefgelaufen.