Face Beautify API — Smooth, Sharpen & Brighten Controls

Beautify faces in photos with adjustable smoothing, sharpening, and brightening. Upload an image and receive the enhanced photo as a binary image.

原始信息汇总

Face Beautify API — Smooth, Sharpen & Brighten Controls 数据集概述

基本信息

• API名称：Face Beautify API — Smooth, Sharpen & Brighten Controls
• 提供商：APISphere
• 类别：Video, Images
• 订阅计划：
  • BASIC: $0.00 / mo
  • PRO: $8.91 / mo
  • ULTRA: $89.91 / mo
  • MEGA: $269.91 / mo

功能概述

Beautify faces in photos with adjustable smoothing, sharpening, and brightening. Upload an image and receive the enhanced photo as a binary image.

目标用户

✅ 适用场景

• Social media and selfie apps adding one-tap photo enhancement
• E-commerce platforms retouching model and product imagery
• Portrait photography workflows needing batch beautification
• Photo booth and event photography applications
• Dating and profile apps offering subtle photo enhancement

❌ 不适用场景

• Full-body retouching (this API targets facial regions)
• Artistic style transfers or cartoon effects (see Cartoonize or Stylize endpoints)
• Video frame processing in real time (single-image endpoint)
• Medical or dermatological skin analysis (see Skin Analysis endpoint)

接口端点

• 端点：POST /v1/face/beauty
• 描述：Upload a JPEG, PNG, or BMP image with optional intensity parameters and receive the beautified image directly as binary output.

请求参数

参数	类型	必需	默认值	描述
image	file	Yes	—	Source image (JPEG, PNG, BMP). Max 10 MB
smooth	string	No	medium	Skin smoothing intensity: low, medium, high
sharpen	string	No	medium	Sharpening intensity: low, medium, high
brighten	string	No	medium	Brightening intensity: low, medium, high

响应

• 成功：Binary image data returned directly with Content-Type: image/png or image/jpeg.
• 错误：返回标准错误信封格式： json { "meta": { "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012", "createdAt": "2026-02-17T15:10:22.456Z", "processingMs": 0 }, "data": null, "warnings": [], "error": { "code": "VALIDATION_ERROR", "message": "Missing or empty image file", "details": [ { "field": "image", "issue": "File is required and cannot be empty" } ] } }

核心特点

• Three independent controls – adjust smoothing, sharpening, and brightening separately
• Three intensity levels – low, medium, and high for fine-grained control
• Direct binary output – receive the processed image ready to display or store
• Natural results – enhancements target facial regions for realistic output
• Consistent error format – standard meta, data, warnings, error envelope for errors

验证与错误

• Missing file – image field is required. Omitting it returns a 400 error.
• Invalid format – only JPEG, PNG, and BMP files are accepted. Other formats return a 400 error.
• File too large – images exceeding 10 MB are rejected with a 400 error.
• Invalid intensity – smooth, sharpen, and brighten must each be low, medium, or high. Invalid values return a 400 error.
• Upstream errors – if the processing service times out or fails, a 502 error is returned.
• Server errors – unexpected failures return a 500 status with details in the error field.
• All error responses follow the same envelope: { "meta": {...}, "data": null, "warnings": [], "error": { ... } }.