Face Slimming API — Portrait & Selfie Retouching

Slim the face in a photo with adjustable intensity while maintaining natural proportions. Upload an image and receive the slimmed result as a binary image.

原始信息汇总

Face Slimming API — Portrait & Selfie Retouching 数据集概述

基本信息

• 数据集名称：Face Slimming API — Portrait & Selfie Retouching
• 类别：Video, Images
• 提供者：APISphere
• 订阅者数量：1
• 订阅计划：
  • BASIC: $0.00 / mo
  • PRO: $8.91 / mo
  • ULTRA: $89.91 / mo
  • MEGA: $269.91 / mo

功能概述

该API用于对照片中的人脸进行瘦脸处理，强度可调，同时保持自然比例。用户上传图像并接收瘦脸后的结果作为二进制图像。

目标用户

适用场景

• 提供面部增强功能的自拍和照片编辑应用。
• 需要批量修图的人像摄影工作流。
• 确保模特图像美观的电子商务平台。
• 内置照片增强工具的社交媒体应用。
• 照相亭和活动摄影应用。

不适用场景

• 全身瘦身或塑形。
• 除瘦脸之外的面部特征修改。
• 实时视频处理。
• 医学或临床面部分析。

API端点

• 端点：POST /v1/face/slim
• 描述：上传JPEG或PNG图像（可选强度参数），接收瘦脸后的图像作为二进制输出。

请求与响应

示例请求

bash curl -X POST "https://your-rapidapi-host/v1/face/slim" -H "X-RapidAPI-Key: YOUR_API_KEY" -F "image=@portrait.jpg" -F "intensity=high"

示例响应

• 成功：直接返回二进制图像数据，Content-Type为image/png或image/jpeg。
• 错误：返回标准错误信封格式，包含meta、data、warnings和error字段。

输入参数

参数	类型	是否必需	默认值	描述
image	file	是	—	源图像（JPEG, PNG），最大10 MB
intensity	string	否	medium	瘦脸强度：low、medium、high

输出数据

• 成功响应：二进制图像（JPEG或PNG）。

验证与错误

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

核心优势

• 三种强度级别：低、中、高，提供精细控制。
• 自然比例：瘦脸处理保留面部特征和整体外观。
• 直接二进制输出：处理后的图像可直接使用。
• 简单的API：仅需图像和可选强度参数。
• 一致的错误格式：错误时返回标准的meta、data、warnings、error信封。