Música
Obtener estado de la música
Recupera el estado y el resultado de una tarea de generación de música
Realice polling a este endpoint para verificar el estado de su tarea de generación de música.
Si la respuesta de creación incluye poll_url, prioriza esa URL exacta para el polling. id y task_id deben tratarse como la misma identidad de tarea asíncrona.
Una tarea pública caducada o no disponible puede devolver 404 async_task_not_found. Si no se puede confirmar que pertenece a la clave API actual, devuelve 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 sondeo preferida cuando la respuesta de creación la proporciona.
Estado de la tarea: pending, processing, completed o failed.
Valor de progreso opcional. Solo se devuelve cuando hay un progreso real disponible; usa status para determinar la finalización.
Los campos dependen de la operación. La música puede devolver audio_url y audio_id; las tareas de solo letras, lyrics; la separación, varios archivos en data. video_url, título, progreso y otros metadatos son opcionales. Comprueba status para determinar la finalización y lee los campos realmente devueltos.
ID de audio opcional que puede usarse con este ID de tarea para operaciones posteriores compatibles.
Lista de salidas opcional, como archivos de pistas separadas con audio_url o url.
URL para descargar el archivo de audio (cuando se haya completado).
URL de la versión en video con visualizador (cuando se haya completado).
Título de la canción generada.
Letras generadas o proporcionadas.
Mensaje de error (cuando falle).
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://cdn.example.com/music/abc123.mp3",
"title": "Night Drive",
"lyrics": "[Verse 1]\nDriving through the night...",
"audio_id": "audio_abc123"
}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