照片变活

优质
小牛编辑
132浏览
2023-12-01

利用人工智能技术将输入照片按照风格进行照片变活,表情驱动静态图可能会花费比较长的时间,需要异步的方式来获得结果,所以我们提供了三个接口以完成这个过程。

API文档说明

接口一:提交静态图生成表情视频任务

  • 请求URl: http://picupapi.tukeli.net/api/v1/faceDriven/submitTaskByUrl?imageUrl=xxxx&templateId=1
  • 请求方式: GET
  • 返回类型: json数据
  • 输入参数:

    (1) 请求参数(Header)

    参数参数类型描述
    APIKEYstring您的专属API Key

    (2) 请求参数

    参数参数类型描述
    imageUrlurl人脸静态图片的网络地址
    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)

    参数参数类型描述
    APIKEYstring您的专属API Key

    (2) 请求参数

    参数参数类型必要
    taskId任务IDtrue

    (3) 响应数据

    { 
      "code": 0, 
      "data": {
        "taskId": 123456,
        "resultUrl": "http://xxxxxxxxxxx", //视频处理完成后的视频地址
        "status":  1 // 0:未完成,1:已完成
      }, 
      "msg": null, 
      "time": 1615368038661 
    }

价格说明

此接口调用需消耗视频秒数,不同模板对应的视频秒数如下:

模版id秒数
03.13s
17.13s
22.13s
36.75s
44.38s
53.75s

常见问题

  • Q:输入的图片格式有什么要求?
  • A:支持PNG、JPG、JPEG、BMP、GIF
  • Q:支持图片大小有限制吗?
  • A:目前上传的分辨率最大4096x4096像素,图片文件大小15MB以下