查询文生音效任务
GET /v1/audio/text-to-audio/{id}：按 task_id 或 external_task_id 查询文生音效任务
GET/v1/audio/text-to-audio/{id}
| 项 | 值 |
|---|---|
| 模式 | 同步查询 |
| 计费 | 查询不收费 |
快速开始
curl "https://api.vibelab.me/v1/audio/text-to-audio/893605946402811985" \
-H "Authorization: Bearer $LOOPTOKEN_API_KEY"响应示例：
{
"code": 0,
"message": "SUCCEED",
"request_id": "6a0d571e-d36c-4811-bb2b-698c94b19a8c",
"data": {
"task_id": "893605946402811985",
"task_status": "succeed",
"task_status_msg": "",
"task_info": {
"external_task_id": "your-id"
},
"task_result": {
"audios": [
{
"id": "893605946402811987",
"url_mp3": "https://example.com/result.mp3",
"url_wav": "https://example.com/result.wav",
"duration_mp3": "3.0",
"duration_wav": "3.0"
}
]
},
"created_at": 1722769557708,
"updated_at": 1722769600000
}
}请求参数
请求头
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
Authorization | string | 是 | - | Bearer $LOOPTOKEN_API_KEY |
路径参数
| 参数 | 类型 | 必填 | 默认 | 说明 |
|---|---|---|---|---|
id | string | 是 | - | 文生音效任务的 task_id，或创建时传入的 external_task_id |
响应
| 字段 | 类型 | 说明 |
|---|---|---|
code | integer | 0 表示成功，其余见错误 |
message | string | 错误信息 |
request_id | string | 请求 ID，排查问题时提供 |
data.task_id | string | 任务 ID |
data.task_status | string | submitted、processing、succeed、failed |
data.task_status_msg | string | 失败原因 |
data.task_info.external_task_id | string | 自定义任务 ID |
data.task_result.audios[].id | string | 音频 ID |
data.task_result.audios[].url_mp3 | string | MP3 地址，30 天后清理，请及时转存 |
data.task_result.audios[].url_wav | string | WAV 地址 |
data.task_result.audios[].duration_mp3、duration_wav | string | 音频时长，单位秒 |
data.created_at、data.updated_at | integer | Unix 毫秒时间戳 |
计费
查询不收费。
错误
| HTTP | code | 触发场景 | 处理 |
|---|---|---|---|
| 404 | 1203 | task not found：任务不存在、不属于当前账号或已超过 30 天 | 核对 id |
通用错误（鉴权、余额、并发、回调地址、上游错误）见 Kling 错误。