跳转到内容

AI 照片背景消除

概览

去除图片背景,抠得干净利落,画质也保得住。

  • 自动识别背景::用 AI 把主体与背景分离开来。
  • 边缘处理精细::主体四周的边缘干净精准。
  • 支持多种类别:人物、商品、动物、汽车、图形等。
  • 便于串联其他 AI 任务:输出的文件 ID 转眼就能接进其他 AI 任务。

接入指南

  • AI 图片去背景怎么做
  1. 调整源图尺寸
    把图片缩放到支持的尺寸范围,详见 文件规格与错误码

  2. 用 File 接口上传文件
    通过 /s2s/v2.0/file 接口上传目标用户图片。

    • 图片要求

    • 重要:只调用 File 接口并不等于上传了文件。您必须手动把文件上传到 File 接口响应中给出的那个 URL,那个 URL 就是您的上传目标,务必确认文件已成功传过去,再继续往下做。
      调用 AI 接口之前,请确认文件已上传成功。先用 File 接口取到一个上传 URL,把文件上传到该位置。上传完成后,您会在响应中收到一个 file_id,调用与该文件相关的 AI 功能时就用它。

      警告: 请注意,若未把文件上传到 File 接口响应中给出的 URL,调用 AI 接口时会得到 500 Server Error / unknown_internal_error 或 404 Not Found 错误。

  3. 执行 AI 任务
    上传完成后,用文件 ID 调用 POST 'task/sod' 执行 AI 任务,并取得用于监控的 task_id。

  4. 用 Webhook 或轮询监控任务状态,直到成功或报错
    用这个 task_id 配置 Webhook 或实现轮询,在整个保留期内监控任务状态。AI 引擎完成任务之前,状态会一直是 running,这一阶段不消耗点数。处理完成后,任务状态会变为 success 或 error。

  5. 任务成功后取回结果
    引擎成功处理您的输入文件、生成出图后,任务状态会变为 'success'。您会得到处理后图片的 URL 以及一个 dst_id,可直接串联下一个 AI 任务,不必把结果图重新上传。 只有这种情况才会消耗点数。若引擎处理失败,任务状态会变为 'error',不消耗点数。
    扣除点数时,系统优先扣除临近到期的点数;到期日相同时,优先扣除最早取得的点数。

  • 应用场景示例: 常见实现方式:

输入与输出

  • 输入
    • Image
  • 类型: image
  • 说明: 前景清楚的图片。

实际应用场景(输入):


  • 输出
    • Foreground image
  • 类型: image
  • 说明: 已去除背景的图片。

实际应用场景(输出):

文件规格与错误码

  • 支持的格式与尺寸
AI 功能支持尺寸文件大小支持格式
AI 图片去背景输入与输出图片的建议与限制如下:
分辨率:4096 × 4096 像素(最长边不得超过 4096 像素)
<10MBJPG 与 PNG
  • 错误码
错误码说明
exceed_max_filesize输入文件大小超出上限
invalid_parameter参数取值无效
error_download_image下载原图出错
error_download_mask下载蒙版图片出错
error_decode_image解码原图出错
error_decode_mask解码蒙版图片出错
error_download_video下载源视频出错
error_decode_video解码源视频出错
error_nsfw_content_detected在原图中检测到不适宜内容(NSFW)
error_no_face源图中未检测到人脸
error_pose源图中检测不到姿态
error_face_parsing源图的人脸分割失败
error_inference推理流程出错
exceed_nsfw_retry_limits为避免生成不适宜内容,重试次数已达上限
error_upload上传结果图片出错
error_multiple_people源图中检测到多人
error_no_shoulder源图中看不到肩膀
error_large_face_angle上传图片中的脸部角度过大
error_hair_too_short输入的头发太短
error_unexpected_video_duration视频时长与 dstDuration 不一致
error_bald_image输入的发型为光头
error_unsupport_ratio输入图片的宽高比不受支持
unknown_internal_error其他

点数消耗

AI 功能消耗点数
AI 图片去背景 V1.01

语言
服务器
https://yce-api-01.makeupar.com