TokenLab

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/tasks/{id}

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

idstringpathrequis

L'ID de la tâche de génération de musique.

Réponse

idstring

ID de la tâche.

task_idstring

Alias du même ID de tâche asynchrone, lorsqu'il est renvoyé.

poll_urlstring

URL de statut pour cette tâche. Interrogez GET /v1/tasks/{id} avec id.

statusstring

Statut de la tâche : pending, processing, completed, failed ou timeout. Une tâche ayant échoué renvoie toujours HTTP 200.

progressinteger

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.

audio_idstring

ID audio source optionnel, utilisable avec l'ID de cette tâche dans les opérations de suivi prises en charge.

dataarray

Tableau de sortie optionnel, incluant les fichiers audio séparés avec audio_url ou url.

audio_urlstring

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.

video_urlstring

URL de la version vidéo avec visualiseur (une fois terminée et renvoyée pour le modèle).

image_urlstring

URL de l'image de couverture, lorsque le modèle en renvoie une.

titlestring

Titre de la chanson générée.

lyricsstring

Paroles générées ou fournies.

errorstring | object

Message d'erreur (en cas d'échec).

error_detailsobject

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.

media_retentionobject

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

Réponse (Terminée)
{
  "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
AuthorizationBearer <token>

Authentification par clé API. Créez ou gérez vos clés API dans Dashboard > API > API Keys.

Emplacement: header

Paramètres de chemin

id*string

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