Música
Obter Status da Música
Recupera o status e o resultado de uma tarefa de geração de música
Consulte este endpoint para verificar o status da sua tarefa de geração de música.
Se a resposta de criação incluir poll_url, priorize essa URL exata para o polling. id e task_id devem ser tratados como a mesma identidade da tarefa assíncrona.
Uma tarefa pública expirada ou indisponível pode retornar 404 async_task_not_found. Se não for possível confirmar a titularidade para a chave API atual, a resposta será 403 task_not_owned.
Parâmetros de Caminho
O ID da tarefa de geração de música.
Resposta
ID da tarefa.
Alias do mesmo ID de tarefa assíncrona, quando retornado.
URL de polling preferencial quando a resposta de criação a fornece.
Status da tarefa: pending, processing, completed ou failed.
Valor de progresso opcional. Retornado apenas quando houver um progresso real disponível; use status para determinar a conclusão.
Os campos dependem da operação. Música pode retornar audio_url e audio_id; tarefas de letras, lyrics; separação, vários arquivos em data. video_url, título, progresso e outros metadados são opcionais. Verifique a conclusão com status e leia os campos realmente retornados.
ID de áudio opcional para usar com este ID de tarefa em operações posteriores compatíveis.
Lista de saídas opcional, incluindo arquivos de faixas separadas com audio_url ou url.
URL para baixar o arquivo de áudio (quando concluído).
URL para a versão em vídeo com visualizador (quando concluído).
Título da música gerada.
Letras geradas ou fornecidas.
Mensagem de erro (quando houver falha).
Requisição
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"Resposta
{
"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"
}Autorização
BearerAuth Autenticação por Chave de API. Crie ou gerencie chaves de API em Dashboard > API > API Keys.
Local: header
Parâmetros de caminho
O ID da tarefa assíncrona retornado por id / task_id, ou incorporado na poll_url
Resposta
application/json
application/json
application/json
application/json