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
GET /v1/music/generations/{id} est un point de terminaison de compatibilité. Il reste pris en charge pour les intégrations existantes. Les nouvelles intégrations doivent interroger GET /v1/tasks/{id} ; voir Obtenir le statut de la tâche.
Appelez GET /v1/tasks/{id} pour vérifier le statut de votre tâche de génération de musique.
id et task_id identifient la même tâche.
Une tâche publique expirée ou indisponible peut renvoyer 404 async_task_not_found. Si la propriété de la tâche ne peut pas être établie pour la clé API actuelle, 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 ID de tâche asynchrone, lorsqu'il est renvoyé.
URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.
Statut de la tâche : pending, processing, completed, failed ou timeout. Une tâche ayant échoué renvoie toujours HTTP 200.
Valeur de progression optionnelle. Renvoyée uniquement lorsqu'une valeur de progression réelle est disponible ; utilisez status pour déterminer l'achèvement.
Les champs de résultat dépendent de l'opération. La musique peut renvoyer audio_url et audio_id ; les tâches contenant uniquement des paroles renvoient lyrics ; la séparation peut renvoyer plusieurs fichiers dans data. video_url, le titre, la progression et d'autres métadonnées sont optionnels. Vérifiez status pour l'achèvement et lisez les champs réellement renvoyés.
ID audio source optionnel, utilisable avec l'ID de cette tâche dans les opérations de suivi prises en charge.
Tableau de sortie optionnel, incluant les fichiers audio séparés avec audio_url ou url.
URL pour télécharger le fichier audio (une fois terminé). Un lien de résultat média TokenLab qui reste valide pendant 30 jours.
URL de la version vidéo avec visualiseur (une fois terminée et renvoyée pour le modèle).
URL de l'image de couverture, lorsque le modèle en renvoie une.
Titre de la chanson générée.
Paroles générées ou fournies.
Message d'erreur (en cas d'échec).
Détails de l'échec lorsque la tâche a échoué : status, message, type, code, retryable et param lorsqu'un champ de requête est en cause.
Statut de conservation des liens de résultat : days et items[] avec url, kind, status et expires_at. Il peut être absent ; les liens fonctionnent toujours. Voir Rétention des données.
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://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123",
"media_retention": {
"days": 30,
"items": [
{
"url": "https://api.tokenlab.sh/v1/media-results/2d7e9a41-8c3b-4b6f-a1e5-7f0c3d9b8e26.mp3?token=…",
"kind": "audio",
"content_type": "audio/mpeg",
"status": "saved",
"expires_at": "2024-02-22T08:54:20.000Z"
}
]
}
}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
application/json
application/json
application/json