根据文件编号获取图片文件的下载链接。
GEThttps://www.aigei.com/open/api/v1/image/downloadURL查询参数
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fileId |
文件编号 | string | 是 | "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X" |
最短字符数:
1
最长字符数:
1024
|
从搜索或详情的 fileList 选择所需文件的 fileId,原样传入;仅限当前用户使用,不能使用预览文件编号。 |
“必返”表示父对象存在且非 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/image/download?fileId=xPACzaFWLfJqiv6FRxsq7TmEIOJ38X
Authorization: Bearer <API_KEY>
以下为响应示例。文件编号仅适用于当前调用用户,下载链接具有有效期,请使用实际调用返回的值。
{
"requestId" : "654f1859707e44408259ebdeed31b161",
"code" : "10001",
"message" : "Success",
"fund" : {
"fundNotice" : "Free",
"fundType" : "down",
"fundValue" : 0,
"fundBalance" : 5000
},
"timeElapsed" : "6700ms",
"data" : {
"file" : {
"fileId" : "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X",
"fileType" : "image",
"fileExtName" : "jpg",
"fileSizeMb" : 0.8,
"fileDownloadUrl" : "http://s1.aigei.com/src/img/jpg/87/8764676b1cf8486f895da07ad5276257.jpg?download/%E9%9B%AA%E6%99%AF%28Snow+landscape%29-jpg_%E7%88%B1%E7%BB%99%E7%BD%91_aigei_com.jpg&e=1791962880&token=P7S2Xpzfz11vAkASLTkfHN7Fw-oOZBecqeJaxypL:iNAGMI0oOjiwvRWKgfAvkbrhHgs=&s=834291&t=f08d9646290d4058b649ae0690133ddf"
}
}
}