音乐
获取音乐状态
获取音乐生成任务的状态和结果
使用创建响应中的任务 ID 查询进度和结果。
如果创建响应中包含 poll_url，请优先直接调用该 URL 轮询。/v1/tasks/{id} 是音乐任务的固定状态端点，id 与 task_id 应视为同一个异步任务标识。
已过期或不可用的公开任务可能返回 404 async_task_not_found。无法确认当前 API 密钥对任务的归属权限时，返回 403 task_not_owned。
路径参数
音乐生成任务 ID。
响应
任务 ID。
同一个异步任务 ID 的别名，仅在返回时存在。
创建响应提供时，优先使用的轮询 URL。
任务状态：pending、processing、completed 或 failed。
可选进度值。仅在任务提供真实进度时返回；请使用 status 判断任务是否完成。
结果字段取决于操作。音乐可能返回 audio_url 和 audio_id；纯歌词任务返回 lyrics；分轨可在 data 中返回多个文件。video_url、标题、进度等信息均为可选。请使用 status 判断完成，并读取实际返回的字段。
可选的源音频 ID，可与本任务 ID 一起用于支持的后续操作。
可选的输出数组，分轨文件可通过 audio_url 或 url 提供。
音频文件的下载 URL（完成时）。
带可视化效果的视频版本 URL（完成时）。
生成的歌曲标题。
生成或提供的歌词。
错误信息（失败时）。
请求
curl --fail-with-body "https://api.tokenlab.sh/v1/tasks/ldtask_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa" \
-H "Authorization: Bearer sk-your-api-key"响应
{
"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"
}授权
BearerAuth API Key 身份验证。在 Dashboard > API > API Keys 中创建或管理 API Key。
位置: header
路径参数
由 id / task_id 返回或嵌入在 poll_url 中的异步任务 ID
响应
application/json
application/json
application/json
application/json