使用音频搜索或详情返回的 fileId,获取所选文件的下载链接。
GEThttps://www.aigei.com/open/api/v1/audio/downloadURL查询参数
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fileId |
文件编号 | string | 是 | "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X" |
最短字符数:
1
最长字符数:
1024
|
从搜索或详情的 fileList 选择所需文件的 fileId,原样传入;仅限当前用户使用,仅接受 fileList 中当前可下载的文件编号。 |
“必返”表示父对象存在且非 null 时必须返回的字段;可选字段可能省略,类型允许 null 时也可能返回 null。
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
requestId |
请求编号 | string / null | 是 | "f0f931dbaf264523a3ba018f44d0954a" |
- | 本次请求的编号,排查问题时请提供。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code |
状态码 | string | 是 | "10001" |
- | 业务状态码;10001 表示成功,其他值表示失败。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
message |
状态说明 | string | 是 | "Success" |
- | 状态或错误说明;以 code 判断成功或失败。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeElapsed |
执行耗时 | string / null | 是 | "508ms" |
- | 请求耗时,单位毫秒,带 ms 后缀。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
fund |
实际扣费信息 | object | 否 | - |
仅支持已列字段
|
登录用户预览或文件下载成功后的实际费用与账户余额;查询、游客调用及失败时省略。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|
fundNotice |
消耗说明 | string | 是 | "Free" |
- | 本次费用说明。
|
||||||
fundType |
资金类型 | string | 是 | "down" |
可选值:
["down"]
|
下载实际扣费币种,down 为铜币。 |
||||||
fundValue |
资金消耗 | number | 是 | 0 |
最小值:
0
|
本次实际扣费金额。 |
||||||
fundBalance |
对应账户余额 | number | 是 | 100 |
- | 调用完成后的账户余额,币种与 fundType 一致。 |
data-成功时返回下载文件及链接,失败时为null。
data · 业务数据 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
file |
下载文件 | object | 是 | - |
仅支持已列字段
|
本次交付的文件及正式下载地址。 |
||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||
|---|---|---|---|---|---|---|---|---|---|---|
fileId |
文件编号 | string | 是 | "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X" |
- | 正式文件编号,用于获取该文件的下载链接;仅限当前用户使用,需原样传入。 |
||||
fileType |
文件类型 | string / null | 否 | "video" |
- | 所下载文件的媒体类型;尺寸、时长等属性见搜索或详情中对应的 fileList 记录。
|
||||
fileExtName |
文件扩展名 | string / null | 否 | "mp4" |
- | 文件扩展名,不带点。 |
||||
fileSizeMb |
文件大小 | number / null | 否 | 0.05 |
最小值:
0
|
文件大小估值,单位MB。 |
||||
fileDownloadUrl |
下载地址 | string | 是 | "https://example.com/open-api/files/video.mp4?e=1792531200&token=example-signature" |
格式:
"uri"
|
正式下载地址,仅下载接口成功时返回;不能使用预览地址替代。下载链接限时有效,请及时下载;失效后需重新获取。 |
示例仅供参考;调用时请使用当前用户获取的编号和链接。
音效和配乐下载
GET https://www.aigei.com/open/api/v1/audio/download?fileId=Bb2Fj1f7DuX7TY0S8bIros0AteEG1M
Authorization: Bearer <API_KEY>
以下为响应字段节选,部分字段已省略。文件编号仅适用于当前调用用户,下载链接具有有效期,请使用实际调用返回的值。
{
"data" : {
"file" : {
"fileId" : "Bb2Fj1f7DuX7TY0S8bIros0AteEG1M",
"fileType" : "audio",
"fileExtName" : "mp3",
"fileSizeMb" : 1
}
}
}