Musique
Obtenir le statut de la musique
Récupère le statut et le résultat d'une tâche de génération de musique
Interrogez cet endpoint pour vérifier le statut de votre tâche de génération de musique.
Si la réponse de création contient poll_url, privilégiez cette URL exacte pour le polling. id et task_id doivent être traités comme le même identifiant de tâche asynchrone.
Une tâche publique expirée ou indisponible peut renvoyer 404 async_task_not_found. Si son appartenance à la clé API actuelle ne peut pas être établie, la réponse est 403 task_not_owned.
Paramètres de chemin
L'ID de la tâche de génération de musique.
Réponse
ID de la tâche.
Alias du même identifiant de tâche asynchrone, lorsqu’il est renvoyé.
URL de polling à privilégier lorsque la réponse de création la fournit.
Statut de la tâche : pending, processing, completed ou failed.
Valeur de progression facultative. Renvoyée uniquement lorsqu’une progression réelle est disponible ; utilisez status pour déterminer la fin de la tâche.
Les champs dépendent de l’opération. La musique peut renvoyer audio_url et audio_id, les tâches de paroles seules lyrics, et la séparation plusieurs fichiers dans data. video_url, le titre, la progression et les autres métadonnées sont facultatifs. Vérifiez la fin avec status et lisez les champs réellement renvoyés.
Identifiant audio facultatif à utiliser avec cet identifiant de tâche pour les opérations de suivi compatibles.
Tableau de sorties facultatif, notamment les pistes séparées avec audio_url ou url.
URL pour télécharger le fichier audio (une fois terminé).
URL vers la version vidéo avec visualiseur (une fois terminé).
Titre de la chanson générée.
Paroles générées ou fournies.
Message d'erreur (en cas d'échec).
Requête
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Réponse
{
"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"
}Autorisation
BearerAuth Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.
Emplacement: header
Paramètres de chemin
L'ID de tâche asynchrone renvoyé par id / task_id, ou intégré dans poll_url
Réponse
application/json
application/json
application/json
application/json