Musik
Musik-Status abrufen
Ruft den Status und das Ergebnis einer Musik-Generierungsaufgabe ab
Fragen Sie diesen Endpunkt ab, um den Status Ihrer Musik-Generierungsaufgabe zu überprüfen.
Wenn die Create-Response poll_url enthält, sollten Sie zum Polling bevorzugt genau diese URL verwenden. id und task_id sollten als dieselbe asynchrone Task-ID behandelt werden.
Ein abgelaufener oder nicht verfügbarer öffentlicher Task kann 404 async_task_not_found zurückgeben. Ist die Zugehörigkeit zum aktuellen API-Schlüssel nicht feststellbar, lautet die Antwort 403 task_not_owned.
Pfad-Parameter
Die ID der Musik-Generierungsaufgabe.
Antwort
Aufgaben-ID.
Alias derselben asynchronen Aufgaben-ID, sofern zurückgegeben.
Bevorzugte Polling-URL, wenn die Erstellungsantwort sie bereitstellt.
Aufgabenstatus: pending, processing, completed oder failed.
Optionaler Fortschrittswert. Wird nur zurückgegeben, wenn ein echter Fortschrittswert verfügbar ist; verwenden Sie status, um den Abschluss zu erkennen.
Ergebnisfelder hängen von der Operation ab. Musik kann audio_url und audio_id, reine Songtexte lyrics und Spurentrennung mehrere Dateien in data liefern. video_url, Titel, Fortschritt und weitere Metadaten sind optional. Prüfen Sie den Abschluss über status und lesen Sie die tatsächlich gelieferten Felder.
Optionale Audio-ID für unterstützte Folgeoperationen zusammen mit dieser Aufgaben-ID.
Optionales Ausgabe-Array, etwa getrennte Audiodateien mit audio_url oder url.
URL zum Herunterladen der Audiodatei (wenn abgeschlossen).
URL zur Videoversion mit Visualizer (wenn abgeschlossen).
Generierter Songtitel.
Generierter oder bereitgestellter Songtext.
Fehlermeldung (wenn fehlgeschlagen).
Anfrage
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Antwort
{
"id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"task_id": "ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"poll_url": "/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa",
"status": "completed",
"audio_url": "https://cdn.example.com/music/abc123.mp3",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123"
}Autorisierung
BearerAuth API-Key-Authentifizierung. Erstellen oder verwalten Sie API-Keys unter Dashboard > API > API Keys.
Ort: header
Pfadparameter
Die asynchrone Task-ID, die über id / task_id zurückgegeben oder in poll_url eingebettet wird
Antwort
application/json
application/json
application/json
application/json