首页
接口服务
接口文档
用户中心

图片处理 Faceswap人脸融合

人脸融合：把目标照片的人脸融合模板照片的身上。本功能仅限娱乐，并对敏感照片进行识别过滤。
把目标照片的人脸融合模板照片的身上。
目标A 模板B

一.您的KEY

点击前往获取KEY ｜【图片处理】点击KEY按钮获取

二.创建请求

请求地址：https://imageapi.ai-gs.cn/v1/faceswap

请求方式：POST

URL：

参数 值
token string 必填参数 点击前往获取KEY

请求头：

参数 值
Content-Type string 必填参数 application/json
Accept string 必填参数
application/json

请求体：

参数 值
image_url string URL或base64必选一
目标图像 URL。该链接需要是可以直接访问的图片，不能是网页内嵌图片。
【脸部建议清晰无遮挡，最小 50 x 50 像素，最大 2048 x 2048 像素，不超过5MB】
image_base64 string URL或base64必选一
目标图像 URL。该链接需要是可以直接访问的图片，不能是网页内嵌图片。
【脸部建议清晰无遮挡，最小 50 x 50 像素，最大 2048 x 2048 像素，不超过5MB】
template_url string URL或base64必选一
模板图像 URL。该链接需要是可以直接访问的图片，不能是网页内嵌图片。
【脸部建议正脸，图片像素宽高不宜过大, 模板图最长边建议不超过 1280，模板图大小需需小于5MB】
template_base64 string URL或base64必选一
模板图像 URL。该链接需要是可以直接访问的图片，不能是网页内嵌图片。
【脸部建议正脸，图片像素宽高不宜过大, 模板图最长边建议不超过 1280，模板图大小需需小于5MB】

方式1：image_url和template_url；方式2：image_base64和template_base64；

创建请求体例子：

  • faceswap 人脸融合
    {
    "image_url": "https://xxx.com/image_name.png",
    "template_url": "https://xxx.com/template_name.jpeg"
}

三.接口返回

创建任务响应状态：

  • 200 成功
    获取图片结果成功。文件请及时下载，生成的图片服务器保留7天，自动删除 
    {
    "code": "success",
    "image_url": "https://xxxx.com/image_name.jpeg",
    "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347"
}
  • 401 输入性错误
    • no_token
      使用的 API 时未携带 token，无法通过校验。
      { "code": "no_token", "detail": "No token specified in url query." }
    • invalid_post
      POST参数不对，缺少参数，或者参数校验不通过
      { "code": "invalid_post", "detail": "Your image_url is empty." }
  • 402 处理中错误
    • invalid_input_image
      输入图片无法下载或者访问。
      { "code": "invalid_input_image", "detail": "get input image error.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • no_face_detected
      输入目标图片无法识别到人脸
      { "code": "no_face_detected", "detail": "no face detected in image.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • no_face_detected
      输入模板图片无法识别到人脸
      { "code": "no_face_detected", "detail": "no face detected in template.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • forbidden
      输入图片出现敏感内容
      { "code": "forbidden", "detail": "input image contain sensitive contents.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • image_size_limited
      图片的规格超过范围
      { "code": "image_size_limited", "detail": "Image size exceeds the maximum allowed size.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • request_rate_limit
      请求速度太快，请重试
      { "code": "request_rate_limit", "detail": "Request rate limit, once per second.", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
    • false
      其它原因，具体看detail
      { "code": "false", "detail": "Error details", "task_id": "e4d33a96-dd91-580f-aef4-e4ef4b26c347" }
  • 403 账号性错误
    • used_up
      错误代码，API 套餐已经用完，需要充值
      { "code": "used_up", "detail": "Your account does not have enough credits, please recharge." }
    • invalid_api_key
      你的API KEY 错误
      { "code": "invalid_api_key", "detail": "You provide an invalid Image API key." }
  • 500 未知错误
    未知错误，需要联系系统管理员。
    { "code": "unknown", "detail": "Image's server failure occurred, please contact the administrator" }