根据资源编号查看图片素材的作品信息和可用文件。
GEThttps://www.aigei.com/open/api/v1/image/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。 |
|||||||||||||||||||||||||||||||||||
imageProperties |
图片属性 | object | 否 | - |
仅支持已列字段
|
当前文件的图片属性,适用于 fileType=image;未知属性按字段定义省略或返回 null。 |
|||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
format |
文件格式 | string | 否 | "png" |
- | 当前文件的格式。 |
imageWidthPx |
图片宽度 | integer / null | 否 | 1920 |
- | 当前图片文件的宽度,单位像素。 |
imageHeightPx |
图片高度 | integer / null | 否 | 1080 |
- | 当前图片文件的高度,单位像素。 |
transparent |
是否透明 | boolean | 否 | true |
- | 是否包含透明或半透明像素;true 表示包含,false 表示不包含,未知时省略。 |
downloadFund-获取该文件下载链接时的应付费用,已包含适用减免及折扣;查询报价不扣下载费。用户状态或价格配置变化时,以下载时结算为准。
data.fileList[].downloadFund · 文件下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevImageList-每条记录对应一张预览图,同一张图的三档尺寸共用该记录的 fileId;提供各档实际宽高及 mini 水印链接,无预览时为空数组。
data.prevImageList[] · 图片预览列表 · 数组元素| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileId |
预览文件编号 | string | 是 | "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X" |
- | 当前用户的预览图片编号,同一张图的三档尺寸共用此编号;获取预览链接时原样传入。 |
|||||||||||||||||||||
prevType |
预览类型 | string | 是 | "image" |
- | 预览媒体类型。
|
|||||||||||||||||||||
prevExtName |
预览文件扩展名 | string | 是 | "jpg" |
- | 预览文件实际扩展名,不带点。 |
|||||||||||||||||||||
prevMiniWidthPx |
mini宽度 | integer | 是 | 198 |
最小值:
1
|
mini预览图实际宽度,单位像素。 |
|||||||||||||||||||||
prevMiniHeightPx |
mini高度 | integer | 是 | 132 |
最小值:
1
|
mini预览图实际高度,单位像素。 |
|||||||||||||||||||||
prevMiddleWidthPx |
middle宽度 | integer | 是 | 560 |
最小值:
1
|
middle预览图实际宽度,单位像素。 |
|||||||||||||||||||||
prevMiddleHeightPx |
middle高度 | integer | 是 | 373 |
最小值:
1
|
middle预览图实际高度,单位像素。 |
|||||||||||||||||||||
prevLargeWidthPx |
large宽度 | integer | 是 | 1215 |
最小值:
1
|
large预览图实际宽度,单位像素。 |
|||||||||||||||||||||
prevLargeHeightPx |
large高度 | integer | 是 | 810 |
最小值:
1
|
large预览图实际高度,单位像素。 |
|||||||||||||||||||||
prevMiniUrl |
mini水印预览地址 | string | 是 | "https://example.com/open-api/previews/video-mini.jpg" |
- | 完整的 mini 水印预览图签名链接,必须原样使用,不能移除或修改任何参数;其他尺寸通过预览下载接口获取。 |
|||||||||||||||||||||
prevMiniDownloadFund |
小图下载费用 | object | 是 | - |
仅支持已列字段
|
当前调用者获取小图链接的应付费用,包含适用减免及折扣;查询报价不扣下载费,其中 fundValue 为 0 表示免费。 |
|||||||||||||||||||||
|
|||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevMiddleDownloadFund-当前调用者获取中图链接的应付费用,包含适用减免及折扣;查询报价不扣下载费,其中 fundValue 为 0 表示免费。
data.prevImageList[].prevMiddleDownloadFund · 中图下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevLargeDownloadFund-当前调用者获取大图链接的应付费用,包含适用减免及折扣;查询报价不扣下载费,其中 fundValue 为 0 表示免费。
data.prevImageList[].prevLargeDownloadFund · 大图下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
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/image/detail?itemId=9yFOyPJj
Authorization: Bearer <API_KEY>
以下为响应字段节选,文件及预览列表仅展示代表性记录。文件编号仅适用于当前调用用户,下载链接具有有效期,请使用实际调用返回的值。
{
"requestId" : "398995d26fb84d95a1c778b17029c426",
"code" : "10001",
"message" : "Success",
"timeElapsed" : "50224ms",
"data" : {
"itemId" : "9yFOyPJj",
"itemTitle" : "雪景",
"work" : {
"workAuthor" : "顺自然_9",
"workUploadDate" : "2024-05-07",
"workDownloadNumAll" : 2
},
"fileList" : [ {
"fileId" : "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X",
"fileType" : "image",
"fileExtName" : "jpg",
"fileSizeMb" : 0.8,
"imageProperties" : {
"imageWidthPx" : 1280,
"imageHeightPx" : 853,
"transparent" : false
},
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.3
}
} ],
"prevImageList" : [ {
"fileId" : "xPACzaFWLfJqiv6FRxsq7TmEIOJ38X",
"prevType" : "image",
"prevExtName" : "jpg",
"prevMiniWidthPx" : 198,
"prevMiniHeightPx" : 132,
"prevMiddleWidthPx" : 560,
"prevMiddleHeightPx" : 373,
"prevLargeWidthPx" : 1215,
"prevLargeHeightPx" : 810,
"prevMiniDownloadFund" : {
"fundType" : "down",
"fundValue" : 0
},
"prevMiddleDownloadFund" : {
"fundType" : "down",
"fundValue" : 0.2
},
"prevLargeDownloadFund" : {
"fundType" : "down",
"fundValue" : 0.4
}
} ]
},
"quota" : {
"consumed" : 0.2,
"remaining" : 79.8,
"notice" : "API quota consumed: 0.2."
}
}