搜索-创意视频
通过视频编号、关键词或其他筛选条件获取 创意视频结果集合及排序序列
接口地址(URI):/api/videos/search/creative
HTTP请求方式:GET
请求参数:
请求值字段 | 必选 | 类型 | 说明 |
---|---|---|---|
id | false | string | 视频编号,只传id时,keyword可为空. |
keyword | true | string | 关键词搜索。支持多关键词搜索,多关键词用空格分隔 |
sort | false | string | 排序,best 最佳;time最新 |
gender | false | integer | 性别 1 男人;2 女人 |
race | false | integer | 根根据人种筛选:1=中国人;2=亚洲人;3=东方人;4=白色人种;5=黑色人种;6=混血儿;7=中东人 |
people_num | false | integer | 根据包含的人数筛选:1=无人;2=一个人;3=两个人;4=三个人;5=很多人 |
people_age | false | integer | 根据包含的人的年龄筛选:1.婴儿,2.儿童,3.少年,4.青年,5.中年,6.老年 |
license_type | false | string | 授权类型。参数值:rf ,rr RF:非特定使用范围 RR:限定用途类 |
options | false | string | 根据原视频类型进行筛选:0-360p;1-sd; 2-1080p; 3-4k; 5-720p; 6-6k; 8-8k。多个之间用半角逗号分隔。eg:2,3,6,8 |
color_type | false | integer | 根据视频的色彩类别进行筛选:1=黑白2=彩色 |
shot_speed | false | string | 根据视频的播放速度进行筛选: 多个值用逗号分隔。eg:1,2 0=实时1=延时2=慢镜 4=航拍 5=360 6=微观 7=水下 8=特效 |
shooting_age | false | integer | 根据视频的拍摄年代进行筛选:1=当代影片;2=档案影片 |
special_shot_type | false | string | 视频方向:1-横视频,2-竖视频 |
fps_type | false | string | 帧速:多个值用逗号隔开.eg:1,2 1=23.98 2=24 3=25 4=29.97 5=30 6=50 7=59.94 8=60 |
duration | false | string | 时长(时分秒) 支持区间查询和单个查询 区间查询用半角逗号分割. eg: 1,10 (查询等于1~10秒的视频) 单个查询直接写. eg: 12 (查询等于12秒的视频) |
compose_type | false | string | 构图类型: 1特写 2中景 3广角 多个值用逗号隔开 .eg:1,2 |
angle_type | false | string | 视角:多个值用逗号隔开 .eg:1,2 1固定机位 2滑轨镜头 3航拍视角 4高视角 5低视角 6侧面像 7第一人称 8注视镜头 |
page | false | integer | 第几页,仅支持输入数字. 默认值 1 |
nums | false | integer | 每页返回数量 最小值 10. 最大值 100. 默认值 100 |
返回参数:
返回字段 | 说明 |
---|---|
res_id | 视频编号 |
title | 视频标题 |
options | 原视频分辨率. 0-360p;1-sd; 2-1080p; 3-4k; 5-720p; 6-6k; 8-8k |
license_type | 授权类型。返回值:RF ,RR RF:非特定使用范围 RR:限定用途类 |
clip_length | 视频时长,单位秒 |
preview_video_https | 预览视频地址(https) |
small_jpg_https | 视频封面图片地址(https) |
small_frame_jpg_https | 视频预览图片地址(https)。 多张预览图片以“,”分隔 |
total_count | 返回结果总数 |
total_page | 返回结果总页数 |
per_page | 每页结果总数 |
cur_page | 当前页码 |
请求参数示例example value:
Curl: curl -X GET --header 'Accept: application/json' --header 'api-key: xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' --header 'authorization: Bearer xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx' 'https://api.fotomore.com/api/videos/search/creative?keyword=test&page=1&nums=10' Request URL: https://api.fotomore.com/api/videos/search/creative?keyword=test&page=1&nums=10
返回数据示例example value:
{
"status_code": 1,
"message": "ok",
"data": {
"list": [
{
"res_id": "VCG42N1166800751",
"title": "试管中的血液样本",
"options": 3,
"license_type": "RF",
"clip_length": "00:00:10",
"preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/temp/VCG42N1166800751.mp4?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
"small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_1.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
"small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_1.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_2.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_3.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_4.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1166800751_5.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d"
},
{
......
},
{
"res_id": "VCG42N1074276628",
"title": "邮票测试,阿尔法哑光",
"options": 2,
"license_type": "RF",
"clip_length": "00:00:12",
"preview_video_https": "https://video-static-api.fotomore.com/videos/mts_videos/preview/temp/VCG42N1074276628.mp4?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
"small_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_1.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d",
"small_frame_jpg_https": "https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_1.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_2.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_3.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_4.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d,https://video-static-api.fotomore.com/videos/snapshot/VCG42N1074276628_5.jpg?uid=484×tamp=1708582147&sign=ea2abeb99dac02e3a1729aac0cec250d"
}
],
"total_count": 89910,
"total_page": 8991,
"per_page": 10,
"cur_page": 1
}
}