文档首页/ 云空间服务 KooDrive/ API参考/ API/ AI_saas服务调用接口/ 查询音轨列表 - IlistAudioTrackInfo
更新时间：2025-10-22 GMT+08:00
查看PDF
分享

查询音轨列表 - IlistAudioTrackInfo

功能介绍

查询视频文件的音轨信息列表

授权信息

当前API调用无需身份策略权限。

URI

GET /koodrive/ose/v1/audioTrack/{task_id}

表1 路径参数

参数

是否必选

参数类型

描述

task_id

是

String

任务id

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Authorization

是

String

鉴权头

X-Date

是

String

签名时间，用于appId鉴权

X-User-Id

是

String

用户id，不用于appId鉴权

language

否

String

国际化语言标识，符合i18n规范，如zh-CN表示简体中文，en-US表示美式英语，不传默认美式英语

X-AIUser-Id

否

String

用户id，用于appId鉴权，与X-User-Id必选其一，都存在时以X-AIUser-Id的值为准

响应参数

状态码：200

表3 响应Body参数

参数

参数类型

描述

code

String

状态码

msg

String

状态描述

data

Array of AudioTrackInfo objects

音轨信息
表4 AudioTrackInfo

参数

参数类型

描述

fileId

String

归属的音视频文件id

trackType

String

音轨类型，原音轨，合成音轨

language

String

音轨语言

downloadUrl

String

下载链接，生成中的音频无该字段

size

String

音轨文件总大小，单位字节，生成中的音频无该字段

duration

String

音轨时长，生成中的音频无该字段

suffix

String

音轨文件后缀，生成中的音频无该字段

status

String

音轨状态。0:等待中；1:生成中；2:成功；3:失败；

errorCode

String

错误码

errorMsg

String

错误信息

状态码：401

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

msg

String

状态描述

请求示例

获取任务id是FkZRfL8O****************dwQ-pfN6Bs的音轨信息

/koodrive/ose/v1/audioTrack/FkZRfL8O****************dwQ-pfN6Bs

Authorization:Bearer+10f88*********4791e9ff

响应示例

状态码：200

音轨信息列表

{
  "data" : [ {
    "fileId" : "FkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs",
    "trackType" : 0,
    "language" : "en",
    "downloadUrl" : "https://obs-koodrive-ai.obs.cn-north-4.*****.com/koodriveai%2Fsoundtrack%2Ftenants6_liantiao_v2%2F1649319782643880065%2FFkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs%2F20250701084242206.wav?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=HPUA1TI53C2TRM9BJTSA%2F20250703%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20250703T022736Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3D20250701084242206.wav&X-Amz-Signature=45a4cba1d651322d1fa2dc0a67198b38107d2f4498dd78f17831d4e41e4d2920",
    "size" : 19152472,
    "duration" : 54287,
    "suffix" : "wav",
    "status" : 2
  }, {
    "fileId" : "FkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs",
    "trackType" : 1,
    "language" : "cn",
    "downloadUrl" : "https://obs-koodrive-ai.obs.cn-north-4.*****.com/koodriveai%2Fmixer%2Ftenants6_liantiao_v2%2F1649319782643880065%2FFkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs%2FFkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs_cn.m4a?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Credential=HPUA1TI53C2TRM9BJTSA%2F20250703%2Fregion%2Fs3%2Faws4_request&X-Amz-Date=20250703T022736Z&X-Amz-Expires=604800&X-Amz-SignedHeaders=host&response-content-disposition=attachment%3Bfilename%3DFkZRfL8O112ziUyPjOKNPf4dwQ-pfN6Bs_cn.m4a&X-Amz-Signature=d73434b5efff3597b32976adc392c2fb59b24dd21ecb6ccfc49856be844027a6",
    "size" : 447543,
    "duration" : 54286,
    "suffix" : "m4a",
    "status" : 2
  } ],
  "code" : 0,
  "msg" : "Success."
}

状态码

状态码

描述

200

音轨信息列表

401

鉴权失效

相关文档