图片上传到视频点播后，可以调用本接口通过传入多个图片ID，批量获取图片的基本信息及访问地址。
接口说明
本接口仅支持查询上传到视频点播中的图片信息；如需查询通过视频截图生成的截图信息，请调用 ListSnapshots 接口查询。
一次最多可查询 20 个图片的信息。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
vod:GetImageInfos |
list |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| ImageIds |
string |
是 |
图片 ID 列表，多个 ID 之间使用半角逗号（,）分隔，最多支持 20 个 ID。可通过以下方式获取：
|
bbc65bba53fed90de118a7849****,594228cdd14b4d069fc17a8c4a**** |
| AuthTimeout |
integer |
否 |
图片访问地址的过期时间。单位：秒。
|
3600 |
| OutputType |
string |
否 |
输出的图片访问地址的类型。取值范围 ：
|
cdn |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| RequestId |
string |
请求 ID。 |
25818875-5F78-4AF6-D7393642CA58***** |
| ImageInfo |
array<object> |
图片信息列表。 |
|
|
array<object> |
图片信息列表。 |
||
| CreationTime |
string |
图片创建时间。格式为：yyyy-MM-ddTHH:mm:ssZ（UTC 时间）。 |
2018-11-21T02:37:23Z |
| StorageLocation |
string |
图片文件的存储地址。 |
outin-****..oss-cn-shanghai.aliyuncs.com |
| Status |
string |
图片状态。取值：
|
Uploading |
| CateId |
integer |
分类 ID。 |
254766071 |
| Tags |
string |
图片标签。多个标签之间使用半角逗号（,）分隔。 |
tag1,tag2,tag3 |
| ImageType |
string |
图片类型。取值：
|
default |
| CateName |
string |
分类名称。 |
Test |
| Description |
string |
图片描述。 |
Test description |
| AppId |
string |
应用 ID。 |
app-**** |
| URL |
string |
图片访问地址（如果配置了 CDN 域名则为 CDN 地址，否则为 OSS 地址）。 |
http://example.aliyundoc.com/image/default/****.gif?auth_key=**** |
| Title |
string |
图片标题。 |
this is a sample |
| ImageId |
string |
图片 ID。 |
bbc65bba53f9*****ed90de118a7849 |
| Mezzanine |
object |
图片源信息。 |
|
| FileURL |
string |
图片文件的 OSS 地址。 |
https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D |
| OriginalFileName |
string |
上传的图片源文件地址。 |
****.gif |
| Width |
integer |
图片宽度。单位：像素。 |
200 |
| Height |
integer |
图片高度。单位：像素。 |
200 |
| FileSize |
string |
文件大小。单位：字节。 |
8932 |
| NonExistImageIds |
array |
不存在的图片 ID 列表。 |
|
|
string |
不存在的图片 ID 列表。 |
f45cf4eba5c80233389558c39**** |
示例
正常返回示例
JSON格式
{
"RequestId": "25818875-5F78-4AF6-D7393642CA58*****",
"ImageInfo": [
{
"CreationTime": "2018-11-21T02:37:23Z",
"StorageLocation": "outin-****..oss-cn-shanghai.aliyuncs.com",
"Status": "Uploading",
"CateId": 254766071,
"Tags": "tag1,tag2,tag3",
"ImageType": "default",
"CateName": "Test",
"Description": "Test description",
"AppId": "app-****",
"URL": "http://example.aliyundoc.com/image/default/****.gif?auth_key=****",
"Title": "this is a sample",
"ImageId": "bbc65bba53f9*****ed90de118a7849",
"Mezzanine": {
"FileURL": "https://outin-bfefbb*****163e1c7426.oss-cn-XXXXXXXX.aliyuncs.com/image/default/5E84CD536*****D4DAD.png?Expires=1590982353&OSSAccessKeyId=*****&Signature=ALPET74o*****c%3D",
"OriginalFileName": "****.gif",
"Width": 200,
"Height": 200,
"FileSize": "8932"
}
}
],
"NonExistImageIds": [
"f45cf4eba5c80233389558c39****"
]
}错误码
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。