照片变活
优质
小牛编辑
132浏览
2023-12-01
利用人工智能技术将输入照片按照风格进行照片变活,表情驱动静态图可能会花费比较长的时间,需要异步的方式来获得结果,所以我们提供了三个接口以完成这个过程。
API文档说明
接口一:提交静态图生成表情视频任务
- 请求URl: http://picupapi.tukeli.net/api/v1/faceDriven/submitTaskByUrl?imageUrl=xxxx&templateId=1
- 请求方式: GET
- 返回类型: json数据
- 输入参数:
(1) 请求参数(Header)
参数 参数类型 描述 APIKEY string 您的专属API Key (2) 请求参数
参数 参数类型 描述 imageUrl url 人脸静态图片的网络地址 templateId 可选择0,1,2,3,4,5 表情模板索引编号,从0开始,目前支持0,1,2,3,4,5六种表情 (3) 响应数据
{ "code": 0, "data": 123456, //返回任务提交之后的任务ID "msg": null, "time": 1615368038661 }
接口二:异步通知
- 你们需提供一个api地址,用于接收异步通知: 通知会以json格式post到此指定地址,json示例:
{ "eventName":"EVENT_FACE_DRIVEN_TASK_FINISHED", "eventData": { "taskId":123456, "resultUrl": "http://xxxxxxxxxxx", //视频处理完成后的视频地址 "status": 1 // 0:未完成,1:已完成 2:失败,一般为检测不到人脸或者人脸角度太偏 } }
接口三:主动查询的接口
- 请求URl: http://picupapi.tukeli.net/api/v1/faceDriven/getTaskInfo?taskId=123456
- 请求方式: GET
- 输入参数:
(1) 请求参数(Header)
参数 参数类型 描述 APIKEY string 您的专属API Key (2) 请求参数
参数 参数类型 必要 taskId 任务ID true (3) 响应数据
{ "code": 0, "data": { "taskId": 123456, "resultUrl": "http://xxxxxxxxxxx", //视频处理完成后的视频地址 "status": 1 // 0:未完成,1:已完成 }, "msg": null, "time": 1615368038661 }
价格说明
此接口调用需消耗视频秒数,不同模板对应的视频秒数如下:
模版id | 秒数 |
---|---|
0 | 3.13s |
1 | 7.13s |
2 | 2.13s |
3 | 6.75s |
4 | 4.38s |
5 | 3.75s |
常见问题
- Q:输入的图片格式有什么要求?
- A:支持PNG、JPG、JPEG、BMP、GIF
- Q:支持图片大小有限制吗?
- A:目前上传的分辨率最大4096x4096像素,图片文件大小15MB以下