Hairstyle Changer API — Text Style + Optional Hair Color

Change the hairstyle and optionally the hair color in a photo. Describe the desired hairstyle, and receive the transformed image as a binary response.

原始信息汇总

Hairstyle Changer API — Text Style + Optional Hair Color 数据集概述

基本信息

• API名称: Hairstyle Changer API — Text Style + Optional Hair Color
• 类别: Video, Images
• 版本: v1 (current)
• 提供商: APISphere
• 订阅者数量: 1

定价方案

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

功能概述

• 更改照片中的发型，并可选择更改发色。
• 接收对所需发型的文本描述，并返回转换后的图像作为二进制响应。
• 处理完整的转换流程，包括面部检测、头发分割和图像合成。

目标用户

适用场景

• 美容和美发沙龙应用程序，提供虚拟发型试戴。
• 电子商务平台，预览假发和护发产品。
• 社交媒体和娱乐应用程序，具有发型变换功能。
• 个人造型和改妆应用程序。
• 开发人员构建创意照片编辑工具。

不适用场景

• 检测或分类现有发型。
• 全身外观更改（专注于头发区域）。
• 实时视频处理（单图像端点）。
• 仅从文本生成图像（需要源照片）。

接口端点

• 方法: POST
• 路径: /v1/face/hairstyle
• 功能: 上传图像，描述所需的发型，并可选择指定发色。

请求示例

bash curl -X POST "https://your-rapidapi-host/v1/face/hairstyle" -H "X-RapidAPI-Key: YOUR_API_KEY" -F "image=@portrait.jpg" -F "hairstyle=short bob cut with bangs" -F "hair_color=platinum blonde"

响应格式

• 成功: 直接返回二进制图像数据，Content-Type 为 image/png 或 image/jpeg。
• 错误: 返回标准信封格式的JSON错误信息。

核心特性

• 自由文本发型描述：自然描述任何发型，无需预定义列表。
• 可选发色：独立更改颜色或与样式一起更改。
• 直接二进制输出：接收可直接使用的转换后图像。
• 广泛的格式支持：接受 JPEG、PNG、BMP、WEBP 和 GIF。
• 一致的错误格式：错误时使用标准的 meta、data、warnings、error 信封。

请求参数

参数	类型	是否必需	默认值	描述
image	file	是	—	源图像（JPEG、PNG、BMP、WEBP、GIF）。最大 10 MB
hairstyle	string	是	—	所需发型的描述（例如，“short bob cut”）
hair_color	string	否	—	可选发色（例如，“platinum blonde”、“dark brown”）

验证与错误

• 缺少文件：image 字段为必填项，缺失则返回 400 错误。
• 缺少发型描述：hairstyle 字段为必填项且不能为空，缺失则返回 400 错误。
• 无效格式：仅接受 JPEG、PNG、BMP、WEBP 和 GIF 文件，其他格式返回 400 错误。
• 文件过大：图像超过 10 MB 将被拒绝，并返回 400 错误。
• 上游错误：如果处理服务超时或失败，则返回 502 错误。
• 服务器错误：意外故障返回 500 状态，详细信息在 error 字段中。
• 所有错误响应均遵循相同信封格式：{ "meta": {...}, "data": null, "warnings": [], "error": { ... } }。