Facial Expression Changer API - Binary Image Response

Change the facial expression in a photo. Choose from 8 expressions — dimple smile, big grin, cool, sad, and more — and receive the transformed image.

原始信息汇总

面部表情更改API - 二进制图像响应

概述

该API用于更改照片中的面部表情。用户可以从8种表情中选择，并接收转换后的图像。

核心功能

• 更改面部表情：从8种表情中选择，对上传的照片进行表情修改。
• 输出格式：成功时直接返回二进制图像数据（JPEG或PNG格式）。

可用表情

dimple_smile, pear_dimple_smile, big_grin, standard_grin, cool, sad, forced_smile, open_eyes

目标用户

• 照片修图服务，用于修复肖像和集体照中的表情。
• 电子商务平台，用于标准化商品目录中模特的表情。
• 娱乐和社交应用，用于添加表情更改功能。
• 营销团队，用于确保宣传图片中的表情平易近人。
• 开发人员，用于构建创意人脸处理工具。

非目标用途

• 检测或分类现有表情（请使用面部分析端点）。
• 实时更改视频帧中的表情（此为单图像端点）。
• 修改非人脸上的表情。
• 在没有输入图像的情况下从头生成人脸。

端点

• 方法：POST
• 路径：/v1/face/expression

请求参数

参数	类型	必需	默认值	描述
image	file	是	—	源图像（JPEG, PNG）。最大10 MB
expression	string	否	dimple_smile	表情类型（见可用表情列表）

响应

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

错误处理

• 缺少文件：image字段为必填项，缺失则返回400错误。
• 无效格式：仅接受JPEG和PNG文件，其他格式返回400错误。
• 文件过大：图像超过10 MB将被拒绝，返回400错误。
• 无效表情：expression必须是8个支持值之一，无效值返回400错误并列出允许的表情。
• 上游错误：如果处理服务超时或失败，返回502错误。
• 服务器错误：意外故障返回500状态码，详细信息在error字段中。

定价方案

• BASIC：$0.00 / 月
• PRO：$8.91 / 月
• ULTRA：$89.91 / 月
• MEGA：$269.91 / 月

提供商信息

• API创建者：APISphere
• 类别：Video, Images