Face Filter API - One Upload, Binary Image Response

Apply a stylistic filter to an image with adjustable strength. Upload a photo and receive the filtered result as a binary image.

原始信息汇总

Face Filter API - One Upload, Binary Image Response 数据集概述

基本信息

• 数据集名称: Face Filter API - One Upload, Binary Image Response
• 类别: Video, Images
• 提供者: APISphere
• 订阅者数量: 1

价格方案

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

API概述

应用具有可调节强度的风格化滤镜到图像。上传一张照片并接收作为二进制图像的滤镜处理结果。

目标用户

适用场景

• 需要滤镜效果的图片编辑和社交媒体应用。
• 营销团队对活动图像应用一致的视觉处理。
• 内容平台为用户提供创意图片工具。
• 个人资料和头像增强功能。
• 需要风格化滤镜的批量图像处理流程。

不适用场景

• 模仿特定绘画的艺术风格迁移（请使用Stylize端点）。
• 卡通或动漫变换（请使用Cartoonize端点）。
• 色彩校正或白平衡调整。
• 实时视频滤镜处理（此为单图像端点）。

端点

• 方法: POST
• 路径: /v1/face/filter
• 描述: 上传JPEG、PNG或BMP图像（可选强度参数），并接收作为二进制输出的滤镜处理后的图像。

请求参数

参数	类型	必需	默认值	描述
image	file	是	—	源图像（JPEG, PNG, BMP）。最大10 MB。
strength	string	否	medium	滤镜强度：low, medium, high。

响应

• 成功: 直接返回二进制图像数据，Content-Type为image/png或image/jpeg。
• 错误: 返回标准信封格式的错误响应：{ "meta": {...}, "data": null, "warnings": [], "error": { ... } }。

验证与错误

• 缺少文件: image字段为必需，缺失则返回400错误。
• 无效格式: 仅接受JPEG、PNG和BMP文件，其他格式返回400错误。
• 文件过大: 超过10 MB的图像将被拒绝，返回400错误。
• 无效强度: strength必须为low、medium或high，无效值返回400错误。
• 上游错误: 如果处理服务超时或失败，返回502错误。
• 服务器错误: 意外故障返回500状态，详细信息在error字段中。

特点

• 可调节强度: 低、中、高三种强度，实现精细控制。
• 直接二进制输出: 接收可直接显示或存储的滤镜处理后的图像。
• 简单的API: 仅需图像和一个可选的强度参数。
• 一致的错误格式: 错误采用标准的meta、data、warnings、error信封格式。