按关键词、分类和文件条件搜索视频素材。
POSThttps://www.aigei.com/open/api/v1/video/searchJSON请求体
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
keyword |
搜索关键词 | string | 是 | "城市夜景" |
最短字符数:
1
最长字符数:
200
|
要搜索的内容,不可仅含空白。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
cat |
搜索分类 | string | 是 | "video" |
- | 必填。选择视频素材的子分类,不接受其他资源类别。
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pageNumber |
页码 | integer | 否 | 1 |
最小值:
1
默认值:
1
|
查询页码,默认 1。返回的 pageNumber × pageSize < itemTotal 时还有下一页,保持条件不变并将页码加 1;不能因本页条数不足或为空就判断结束。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
condition |
筛选条件 | object | 否 | - |
仅支持已列字段
|
按文件属性筛选素材,未填写的条件不参与筛选。fileCommon 与当前分类的专属条件可单独使用,也可组合使用;组合时共同生效。返回的 fileList 不逐项按这些条件过滤,选取文件时需核对实际规格。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileCommon |
通用文件筛选条件 | object | 否 | - |
仅支持已列字段
|
用途:按主文件大小和文件格式筛选。 适用范围:所有已列分类;格式须在当前 cat 支持的范围内。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileSizeMbMin |
文件大小下限 | integer | 否 | 1 |
最小值:
1
最大值:
1048576
|
主文件大小下限,单位 MB,仅接受正整数,不包含边界。 |
||||||||||||||||||
fileSizeMbMax |
文件大小上限 | integer | 否 | 100 |
最小值:
1
最大值:
1048576
|
主文件大小上限,单位 MB,仅接受正整数,不包含边界;不得小于下限。 |
||||||||||||||||||
fileExtNameIn |
文件扩展名 | string | 否 | "mp4,mov" |
最短字符数:
1
最长字符数:
256
|
扩展名使用小写且不带点,多选以英文逗号分隔,仅接受当前资源类型列出的格式。不限制时省略字段;不接受空字符串、连续逗号或末尾逗号。
|
fileVideo{ … }用途:按视频时长、宽度和版式筛选。
适用范围:video、videoFootage、videoEffect、videoBg、videoShort、videoCreative、videoVr。
condition.fileVideo · 视频文件筛选条件 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必填 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
videoDurationSecondsMin |
视频时长下限 | integer | 否 | 10 |
最小值:
1
最大值:
604800
|
视频时长下限,单位秒,包含边界。 |
||||||||||||||||||||||||
videoDurationSecondsMax |
视频时长上限 | integer | 否 | 60 |
最小值:
1
最大值:
604800
|
视频时长上限,单位秒,包含边界;不得小于下限。 |
||||||||||||||||||||||||
videoWidthPxMin |
视频宽度下限 | integer | 否 | 1920 |
最小值:
1
最大值:
100000
|
视频宽度下限,单位像素,包含边界。 |
||||||||||||||||||||||||
videoWidthPxMax |
视频宽度上限 | integer | 否 | 3840 |
最小值:
1
最大值:
100000
|
视频宽度上限,单位像素,包含边界;不得小于下限。 |
||||||||||||||||||||||||
videoLayoutEq |
视频版式 | string | 否 | "16_9" |
- | 选择一种视频方向或宽高比。
|
“必返”表示父对象存在且非 null 时必须返回的字段;可选字段可能省略,类型允许 null 时也可能返回 null。
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
requestId |
请求编号 | string / null | 是 | "f0f931dbaf264523a3ba018f44d0954a" |
- | 本次请求的编号,排查问题时请提供。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
code |
状态码 | string | 是 | "10001" |
- | 业务状态码;10001 表示成功,其他值表示失败。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
message |
状态说明 | string | 是 | "Success" |
- | 状态或错误说明;以 code 判断成功或失败。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
timeElapsed |
执行耗时 | string / null | 是 | "508ms" |
- | 请求耗时,单位毫秒,带 ms 后缀。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
data |
业务数据 | object / null | 是 | - |
仅支持已列字段
|
成功时返回分页搜索结果,失败时为null。 |
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
itemTotal |
匹配总数 | integer | 是 | 35 |
最小值:
0
|
搜索匹配总数,包含后续可能被过滤的不可用素材,不保证等于各页 itemList 数量之和;用于分页判断。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pageNumber |
页码 | integer | 是 | 1 |
最小值:
1
|
实际查询页码,从1开始。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
pageSize |
每页容量 | integer | 是 | 10 |
最小值:
1
|
服务端确定的每页容量,仅用于分页判断,不能作为请求参数。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
itemCount |
本页数量 | integer | 是 | 1 |
最小值:
0
|
本页实际返回的资源数量,等于 itemList 长度。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
itemList |
资源列表 | array | 是 | - |
- | 当前页资源列表;条目结构与详情接口一致。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
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.itemList[].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。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
videoProperties |
视频属性 | object | 否 | - |
仅支持已列字段
|
当前文件的视频属性,适用于 fileType=video;未知属性按字段定义省略或返回 null。 |
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|
|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | ||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
format |
文件格式 | string | 否 | "mp4" |
- | 当前文件的格式。 |
||||||||||||
videoWidthPx |
视频宽度 | integer / null | 否 | 1920 |
- | 当前视频文件的宽度,单位像素。 |
||||||||||||
videoHeightPx |
视频高度 | integer / null | 否 | 1080 |
- | 当前视频文件的高度,单位像素。 |
||||||||||||
videoDurationSeconds |
视频时长 | integer / null | 否 | 30 |
- | 视频时长估值,单位秒。 |
||||||||||||
videoQuality |
视频画质 | string | 否 | "hd" |
- | 分级依据:按视频宽度分档,竖屏同样适用;宽度未知或非正数时为sd。
|
||||||||||||
mute |
是否静音 | boolean | 否 | false |
- | true 表示静音,false 表示有声;未知时省略。 |
downloadFund-获取该文件下载链接时的应付费用,已包含适用减免及折扣;查询报价不扣下载费。用户状态或价格配置变化时,以下载时结算为准。
data.itemList[].fileList[].downloadFund · 文件下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevImageList-每条记录对应一张预览图,同一张图的三档尺寸共用该记录的 fileId;提供各档实际宽高及 mini 水印链接,无预览时为空数组。
data.itemList[].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.itemList[].prevImageList[].prevMiddleDownloadFund · 中图下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevLargeDownloadFund-当前调用者获取大图链接的应付费用,包含适用减免及折扣;查询报价不扣下载费,其中 fundValue 为 0 表示免费。
data.itemList[].prevImageList[].prevLargeDownloadFund · 大图下载费用 · 对象子属性| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
fundType |
结算类型 | string | 是 | "down" |
可选值:
["down"]
|
固定为 down:登录用户使用铜币,游客使用游客下载币。 |
fundValue |
下载应付数量 | number | 是 | 0.3 |
最小值:
0
|
文件下载应付金额,已包含适用减免及折扣;0 表示免费。 |
prevVideoList-预览视频列表,格式、分辨率和时长以返回属性为准;无预览时为空数组。
data.itemList[].prevVideoList[] · 视频预览列表 · 数组元素| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 | |||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
fileId |
预览文件编号 | string | 是 | "OLEhO7hRefDYs8btrYix4f64Sm8ELJv" |
- | 当前用户的预览文件编号;获取预览链接时原样传入。 |
|||||||||||||||||||||
prevType |
预览类型 | string | 是 | "video" |
- | 预览媒体类型。
|
|||||||||||||||||||||
prevExtName |
预览文件扩展名 | string | 是 | "mp4" |
- | 预览文件实际扩展名,不带点。 |
|||||||||||||||||||||
prevFileDurationSeconds |
预览时长 | integer / null | 否 | 35 |
- | 当前预览文件的时长估值,单位秒。 |
|||||||||||||||||||||
prevFileWidthPx |
预览视频宽度 | integer / null | 否 | 640 |
- | 预览视频宽度,单位像素;未知时省略。 |
|||||||||||||||||||||
prevFileHeightPx |
预览视频高度 | integer / null | 否 | 360 |
- | 预览视频高度,单位像素;未知时省略。 |
|||||||||||||||||||||
downloadFund |
预览视频下载费用 | object | 是 | - |
仅支持已列字段
|
当前调用者获取试看视频链接的应付费用,包含适用减免及折扣;查询报价不扣下载费,其中 fundValue 为 0 表示免费。 |
|||||||||||||||||||||
|
|||||||||||||||||||||||||||
| 参数名 | 中文名称 | 数据类型 | 必返 | 示例 | 取值约束 | 功能描述 |
|---|---|---|---|---|---|---|
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." |
- | 本次额度使用情况,不表示资金消费。 |
示例仅供参考;调用时请使用当前用户获取的编号和链接。
视频搜索
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "冰岛", "cat" : "video", "pageNumber" : 1, "condition" : { "fileCommon" : { "fileSizeMbMin" : 1, "fileSizeMbMax" : 100, "fileExtNameIn" : "mp4,mov" }, "fileVideo" : { "videoDurationSecondsMin" : 5, "videoDurationSecondsMax" : 60, "videoWidthPxMin" : 1279, "videoLayoutEq" : "16_9" } } }
高清实拍搜索(videoFootage)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "高清实拍", "cat" : "videoFootage", "pageNumber" : 1 }
后期特效搜索(videoEffect)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "后期特效", "cat" : "videoEffect", "pageNumber" : 1 }
舞台背景搜索(videoBg)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "舞台背景", "cat" : "videoBg", "pageNumber" : 1 }
短视频搜索(videoShort)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "短视频", "cat" : "videoShort", "pageNumber" : 1 }
创意片库搜索(videoCreative)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "创意片库", "cat" : "videoCreative", "pageNumber" : 1 }
VR视频搜索(videoVr)
POST https://www.aigei.com/open/api/v1/video/search Authorization: Bearer <API_KEY> Content-Type: application/json { "keyword" : "VR视频", "cat" : "videoVr", "pageNumber" : 1 }
以下为视频资源的完整响应示例,列表仅展示少量记录。example.com 地址用于展示链接格式;实际链接、文件编号、耗时及费用以当前用户的接口返回为准。
{
"requestId" : "eb332014b4294f5988b79b10b50c7bc5",
"code" : "10001",
"message" : "Success",
"timeElapsed" : "47842ms",
"data" : {
"itemTotal" : 1,
"pageNumber" : 1,
"pageSize" : 40,
"itemCount" : 1,
"itemList" : [ {
"itemId" : "R0FBGrbj",
"itemTitle" : "汽车在冰岛风景区行驶",
"work" : {
"workAuthor" : "Footageshow",
"workUploadDate" : "2024-07-25",
"workDownloadNumAll" : 18,
"format" : "mov"
},
"fileList" : [ {
"fileId" : "zLbhOjh5MCmGs6luyniA5unxI3GQ8R",
"fileType" : "video",
"fileExtName" : "mp4",
"fileSizeMb" : 14,
"videoProperties" : {
"format" : "mov",
"videoWidthPx" : 1920,
"videoHeightPx" : 1080,
"videoDurationSeconds" : 9,
"videoQuality" : "k2",
"mute" : true
},
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.3
}
}, {
"fileId" : "YrRU7GhQ8fplserC8nt1PCA8hE1Mmlj",
"fileType" : "video",
"fileExtName" : "mp4",
"fileSizeMb" : 2,
"videoProperties" : {
"videoWidthPx" : 1280,
"videoHeightPx" : 720,
"videoDurationSeconds" : 9,
"videoQuality" : "hd"
},
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.3
}
} ],
"prevImageList" : [ {
"fileId" : "BlZULVh7DuJrsWjC8Mtr9f0lFxOl6AY",
"prevType" : "image",
"prevExtName" : "jpg",
"prevMiniWidthPx" : 234,
"prevMiniHeightPx" : 132,
"prevMiddleWidthPx" : 560,
"prevMiddleHeightPx" : 315,
"prevLargeWidthPx" : 1920,
"prevLargeHeightPx" : 1080,
"prevMiniUrl" : "https://example.com/open-api/previews/video-mini.jpg",
"prevMiniDownloadFund" : {
"fundType" : "down",
"fundValue" : 0
},
"prevMiddleDownloadFund" : {
"fundType" : "down",
"fundValue" : 0.2
},
"prevLargeDownloadFund" : {
"fundType" : "down",
"fundValue" : 0.4
}
} ],
"prevVideoList" : [ {
"fileId" : "OLEhO7hRefDYs8btrYix4f64Sm8ELJv",
"prevType" : "video",
"prevExtName" : "mp4",
"prevFileWidthPx" : 300,
"prevFileHeightPx" : 168,
"prevFileDurationSeconds" : 5,
"downloadFund" : {
"fundType" : "down",
"fundValue" : 0.6
}
} ]
} ]
},
"quota" : {
"consumed" : 0.2,
"remaining" : 79.8,
"notice" : "API quota consumed: 0.2."
}
}