根据资源编号查看音频素材的作品信息和可用文件。
GEThttps://www.aigei.com/open/api/v1/audio/detailURL查询参数
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
itemId |
资源编号 | string | 是 | "9yFOyPJj" |
最短字符数:
1
最长字符数:
256
|
当前用户的资源编号;查看详情时原样传入,不可跨用户使用。 |
“必返”表示父对象存在且非 null 时必须返回的字段;可选字段可能省略,类型允许 null 时也可能返回 null。
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
requestId |
请求编号 | string / null | 是 | "f0f931dbaf264523a3ba018f44d0954a" |
- | 本次请求的编号,排查问题时请提供。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code |
状态码 | string | 是 | "10001" |
- | 业务状态码;10001 表示成功,其他值表示失败。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
message |
状态说明 | string | 是 | "Success" |
- | 状态或错误说明;以 code 判断成功或失败。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeElapsed |
执行耗时 | string / null | 是 | "508ms" |
- | 请求耗时,单位毫秒,带 ms 后缀。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data |
业务数据 | object / null | 是 | - |
仅支持已列字段
|
成功时返回资源详情,失败时为 null。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
itemId |
资源编号 | string | 是 | "9yFOyPJj" |
- | 当前用户的资源编号;查看详情时原样传入,不可跨用户使用。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
itemTitle |
资源标题 | string | 是 | "城市夜景" |
- | 资源标题。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
work |
作品信息 | object | 是 | - |
仅支持已列字段
|
作品的作者、上传日期、下载次数及主文件格式。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
workAuthor |
作者昵称 | string / null | 否 | "爱给创作者" |
- | 作者昵称。 |
workUploadDate |
上传日期 | string / null | 否 | "2026-09-16" |
- | 作品上传日期,格式为 yyyy-MM-dd。 |
workDownloadNumAll |
累计下载次数 | integer / null | 否 | 1024 |
最小值:
0
|
作品累计下载次数。 |
format |
文件格式 | string | 否 | "mp4" |
- | 作品主文件的格式,可能与可下载文件的格式不同。 |
fileList-素材的可下载文件版本,包含格式、规格及下载报价。搜索条件用于筛选素材,不逐项过滤此列表;选择文件时需核对其规格,并使用对应 fileId 获取下载链接。
data.fileList[] · 可下载文件列表 · 数组元素| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileId |
文件编号 | string | 是 | "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X" |
- | 正式文件编号,用于获取该文件的下载链接;仅限当前用户使用,需原样传入。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fileType |
文件类型 | string / null | 否 | "video" |
- | 当前文件的媒体类型。 属性读取:video、image、audio 分别对应 videoProperties、imageProperties、audioProperties;非当前类型的属性可能省略。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fileExtName |
文件扩展名 | string / null | 否 | "mp4" |
- | 文件扩展名,不带点。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fileSizeMb |
文件大小 | number / null | 否 | 0.05 |
最小值:
0
|
文件大小估值,单位MB。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
audioProperties |
音频属性 | object | 否 | - |
仅支持已列字段
|
当前文件的音频属性,适用于 fileType=audio;未知属性按字段定义省略或返回 null。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format |
文件格式 | string | 否 | "mp3" |
- | 当前文件的格式。 |
||||||||||||
audioDurationSeconds |
音频时长 | integer / null | 否 | 30 |
- | 音频时长估值,单位秒。 |
||||||||||||
audioSampleRateHz |
音频采样率 | integer / null | 否 | 44100 |
- | 音频采样率,单位Hz。 |
||||||||||||
audioBitRateKbps |
音频比特率 | integer / null | 否 | 320 |
- | 当前音频文件的比特率,单位 kbps。 |
||||||||||||
audioChannel |
音频声道 | string / null | 否 | "stereo" |
- | 音频声道;未知时省略。
|
||||||||||||
audioQuality |
音质 | string | 否 | "SD" |
- | 分级依据:FLAC、APE、AIF、AIFF 归为 SQ;其他格式按码率分档,码率未知时为 LD。 说明:SQ 是音质档位,不保证编码无损。
|
downloadFund-获取该文件下载链接时的应付费用,已包含适用减免及折扣;查询报价不扣下载费。用户状态或价格配置变化时,以下载时结算为准。
data.fileList[].downloadFund · 文件下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
quota-登录用户搜索或详情成功后的调用额度消耗和剩余量,不是费用;游客、下载调用及失败时省略。
quota · 调用额度 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
consumed |
本次消耗额度 | number | 是 | 0.2 |
最小值:
0
|
本次成功调用实际消耗的额度,保留原始精度,不是费用。 |
remaining |
剩余调用额度 | number | 是 | 79.8 |
- | 本次扣减后的查询账户剩余额度。 |
notice |
额度消耗说明 | string | 是 | "API quota consumed: 0.2." |
- | 本次额度使用情况,不表示资金消费。 |
示例仅供参考;调用时请使用当前用户获取的编号和链接。
音效和配乐详情
GET https://www.aigei.com/open/api/v1/audio/detail?itemId=ykFmnaly
Authorization: Bearer <API_KEY>
以下为响应字段节选,文件及预览列表仅展示代表性记录。文件编号仅适用于当前调用用户,下载链接具有有效期,请使用实际调用返回的值。
{
"requestId" : "b725854bc94c4af8bbff541c6665a107",
"code" : "10001",
"message" : "Success",
"timeElapsed" : "26583ms",
"data" : {
"itemId" : "ykFmnaly",
"itemTitle" : "冰天雪地",
"work" : {
"workAuthor" : "暴风视频支持",
"workUploadDate" : "2024-06-20",
"workDownloadNumAll" : 0
},
"fileList" : [ {
"fileId" : "Bb2Fj1f7DuX7TY0S8bIros0AteEG1M",
"fileType" : "audio",
"fileExtName" : "mp3",
"fileSizeMb" : 1,
"audioProperties" : {
"audioDurationSeconds" : 35,
"audioSampleRateHz" : 44100,
"audioBitRateKbps" : 256,
"audioChannel" : "stereo",
"audioQuality" : "SD"
},
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.3
}
}, {
"fileId" : "GmoUrpFX9fnLtAOuLyiERcQ7clvzpZ",
"fileType" : "audio",
"fileExtName" : "mp3",
"audioProperties" : {
"format" : "mp3",
"audioDurationSeconds" : 35
},
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.3
}
} ]
},
"quota" : {
"consumed" : 0.2,
"remaining" : 79.8,
"notice" : "API quota consumed: 0.2."
}
}