# 查询音轨列表 - IlistAudioTrackInfo
#### 功能介绍
查询视频文件的音轨信息列表
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /koodrive/ose/v1/audioTrack/{task_id}
表1路径参数 
| 参数      | 是否必选 | 参数类型   | 描述   |
|:---|:---|:---|:---|
| task_id | 是    | String | 任务id |
   
#### 请求参数
表2请求Header参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                           |
|:---|:---|:---|:---|
| Authorization | 是    | String | 鉴权头                                                                                                                                                                                                                          |
| X-Date        | 是    | String | 参数解释：签名时间，用于appId鉴权 约束限制：距当前时间15分钟以内，不能晚于当前时间 取值范围：日期格式，yyyMMdd'T'HHmmss'Z'，例：20251103T070140Z 默认取值：不涉及 |
| 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 | 音轨信息 |
   
 表4AudioTrackInfo 
| 参数                 | 参数类型    | 描述                              |
|:---|:---|:---|
| fileId             | String  | 归属的音视频文件id                      |
| trackType          | String  | 音轨类型，原音轨，合成音轨                   |
| language           | String  | 音轨语言                            |
| isSubtitleExternal | Integer | 用户创建智能处理任务时是否提供了字幕文件。0：未提供 1：提供 |
| subtitleLanguage   | 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",
    "isSubtitleExternal" : 0,
    "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",
    "isSubtitleExternal" : 0,
    "size" : 447543,
    "duration" : 54286,
    "suffix" : "m4a",
    "status" : 2
  } ],
  "code" : 0,
  "msg" : "Success."
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 音轨信息列表 |
| 401 | 鉴权失效   |