Head Extraction API — Face + Hair PNG with Transparency

Extract the human head (face + hair) from a photo and return a PNG with a transparent background. Upload a portrait and receive the extracted head cutout.

从照片中提取人类头部（面部与毛发），并返回带有透明背景的PNG格式文件。上传一张肖像照，即可获取提取完成的头部抠图结果。

原始信息汇总

Head Extraction API — Face + Hair PNG with Transparency 数据集概述

基本信息

• 数据集名称: Head Extraction API — Face + Hair PNG with Transparency
• 提供者: APISphere
• 类别: Video, Images
• 订阅者数量: 1

功能描述

该API用于从照片中提取人头（面部+头发）区域，并返回一个带有透明背景的PNG图像。用户上传一张肖像照片，即可获得提取出的头部剪切图。

核心特性

• 精确的头部分割: 包含面部和头发，具有准确的边缘检测。
• 透明背景: 输出带有Alpha通道、可直接使用的PNG图像。
• 无需参数: 仅需上传图像。
• 广泛的格式支持: 接受JPEG、PNG、BMP、WEBP和GIF格式。
• 一致的错误格式: 错误响应遵循标准的 meta、data、warnings、error 信封结构。

适用场景

• 头像和资料图片生成应用
• 照片合成和图形设计工具
• 贴纸、表情符号和自定义贴花创建者
• 证件和工卡照片处理系统
• 生成自定义叠加层的视频会议工具

不适用场景

• 全身分割（仅提取头部区域）
• 非肖像图像的背景移除（请使用背景移除端点）
• 从单张图像中提取多个人头
• 实时视频处理（单图像端点）

API端点

• 端点: POST /v1/face/extract-head
• 功能: 上传图像并接收提取出的、带透明背景的头部PNG图像。
• 请求参数:
  • image (文件，必需): 源图像（JPEG, PNG, BMP, WEBP, GIF），最大10 MB。
• 成功响应: 直接返回二进制PNG图像，Content-Type 为 image/png。

验证与错误

• 缺少文件: image 字段为必需，缺失将返回 400 错误。
• 无效格式: 仅接受指定格式，其他格式返回 400 错误。
• 文件过大: 图像超过10 MB将被拒绝，返回 400 错误。
• 上游错误: 如果处理服务超时或失败，返回 502 错误。
• 服务器错误: 意外故障返回 500 状态，错误详情在 error 字段中。
• 所有错误响应均遵循相同信封结构：{ "meta": {...}, "data": null, "warnings": [], "error": { ... } }。

订阅计划

• BASIC: $0.00 / 月
• PRO: $8.91 / 月
• ULTRA: $35.91 / 月
• MEGA: $89.91 / 月

搜集汇总

背景与挑战

背景概述

该数据集提供API服务，用于从肖像照片中自动提取人像头部（包括脸部和头发），并生成透明背景的PNG图像。用户上传照片后，即可获得去除背景的头部裁剪结果。