Música
Obtener estado de la música
Recupera el estado y el resultado de una tarea de generación de música
GET /v1/music/generations/{id} es un endpoint de compatibilidad. Se mantiene el soporte para integraciones existentes. Las nuevas integraciones deben consultar GET /v1/tasks/{id}; consulte Obtener estado de la tarea.
Llame a GET /v1/tasks/{id} para verificar el estado de su tarea de generación de música.
id y task_id identifican la misma tarea.
Una tarea pública expirada o no disponible puede devolver 404 async_task_not_found. Si no se puede establecer la propiedad de la tarea para la API key actual, la respuesta será 403 task_not_owned.
Parámetros de ruta
El ID de la tarea de generación de música.
Respuesta
ID de la tarea.
Alias del mismo ID de tarea asíncrona, cuando se devuelve.
URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con el id.
Estado de la tarea: pending, processing, completed, failed o timeout. Una tarea fallida sigue devolviendo HTTP 200.
Valor de progreso opcional. Se devuelve solo cuando hay un valor de progreso real disponible; utilice status para determinar la finalización.
Los campos de resultado dependen de la operación. La música puede devolver audio_url y audio_id; las tareas solo de letra devuelven lyrics; la separación puede devolver múltiples archivos en data. video_url, título, progreso y otros metadatos son opcionales. Verifique status para confirmar la finalización y lea los campos devueltos.
ID de audio de origen opcional, utilizable con el ID de esta tarea en operaciones de seguimiento compatibles.
Matriz de salida opcional, que incluye archivos de audio separados con audio_url o url.
URL para descargar el archivo de audio (cuando se completa). Un enlace de resultado multimedia de TokenLab que permanece válido durante 30 días.
URL a la versión de video con visualizador (cuando se completa y se devuelve para el modelo).
URL de la imagen de portada, cuando el modelo devuelve una.
Título de la canción generada.
Letra generada o proporcionada.
Mensaje de error (cuando falla).
Detalles del fallo cuando la tarea falló: status, message, type, code, retryable y param cuando un campo de solicitud es el causante.
Estado de guardado de los enlaces de resultados: days e items[] con url, kind, status y expires_at. Puede estar ausente; los enlaces siguen funcionando. Consulte Retención de datos.
Solicitud
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Respuesta
{
"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"
}
]
}
}Autorización
BearerAuth Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.
Ubicación: header
Parámetros de ruta
El ID de tarea asíncrona devuelto por id / task_id, o incrustado en poll_url
Respuesta
application/json
application/json
application/json
application/json
application/json
application/json
application/json