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

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

idstringpathobligatorio

El ID de la tarea de generación de música.

Respuesta

idstring

ID de la tarea.

task_idstring

Alias del mismo ID de tarea asíncrona, cuando se devuelve.

poll_urlstring

URL de estado para esta tarea. Consulte GET /v1/tasks/{id} con el id.

statusstring

Estado de la tarea: pending, processing, completed, failed o timeout. Una tarea fallida sigue devolviendo HTTP 200.

progressinteger

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.

audio_idstring

ID de audio de origen opcional, utilizable con el ID de esta tarea en operaciones de seguimiento compatibles.

dataarray

Matriz de salida opcional, que incluye archivos de audio separados con audio_url o url.

audio_urlstring

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.

video_urlstring

URL a la versión de video con visualizador (cuando se completa y se devuelve para el modelo).

image_urlstring

URL de la imagen de portada, cuando el modelo devuelve una.

titlestring

Título de la canción generada.

lyricsstring

Letra generada o proporcionada.

errorstring | object

Mensaje de error (cuando falla).

error_detailsobject

Detalles del fallo cuando la tarea falló: status, message, type, code, retryable y param cuando un campo de solicitud es el causante.

media_retentionobject

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

Response (Completed)
{
  "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
AuthorizationBearer <token>

Autenticación con API Key. Cree o gestione API keys en Dashboard > API > API Keys.

Ubicación: header

Parámetros de ruta

id*string

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