Skip to main content
POST
/
portrait
/
effects
/
hairstyle-editor-pro
Hairstyle Editor Pro
curl --request POST \
  --url https://api.aihairstyle.cn/portrait/effects/hairstyle-editor-pro \
  --header 'Content-Type: multipart/form-data' \
  --header 'ailabapi-api-key: <api-key>' \
  --form hair_style=TinfoilPerm \
  --form color=blonde \
  --form image_size=1 \
  --form task_type=async \
  --form image=@example-file
{
  "request_id": "<string>",
  "log_id": "<string>",
  "error_code": 123,
  "error_msg": "<string>",
  "error_detail": {
    "status_code": 123,
    "code": "<string>",
    "code_message": "<string>",
    "message": "<string>"
  },
  "task_id": "<string>",
  "result": [
    "<string>"
  ]
}

​
请求

  • URL: /portrait/effects/hairstyle-editor-pro
  • 方法: POST
  • Content-Type: multipart/form-data
照片验证指南为了确保用户上传的照片符合发型处理 API 的要求，我们建议将工作流分为两个阶段：人脸分析和发型处理。这种方法通过在前端验证图像来最大程度地减少错误等待时间，确保它们在进行发型处理之前符合 API 标准。这可以增强整体用户体验。有关详细信息，请参阅照片验证指南。

​
图片要求

  • 图片格式: PNG JPG JPEG
  • 图片大小: 不超过3MB。
  • 图片分辨率: 大于200x200px，小于1999x1999px。
  • 最小面部比例: 为确保效果，图像中面部的比例不能小于20%。
  • 面部完整性: 为确保效果，图像中的面部理想情况下不应被遮挡。
  • 面部角度: 为确保效果，图像中的面部理想情况下应为正面，向左或向右旋转不超过45度。
有效性示例图片无效原因
✅
Hairstyle Changer Pro
Hairstyle Changer Pro
有效
❌
Hairstyle Changer Pro
Hairstyle Changer Pro
不包含人脸
Hairstyle Changer Pro
Hairstyle Changer Pro
面部不完整
Hairstyle Changer Pro
Hairstyle Changer Pro
面部被遮挡
Hairstyle Changer Pro
Hairstyle Changer Pro
面部比例过小
Hairstyle Changer Pro
Hairstyle Changer Pro
面部比例过大

​
请求头

字段必填类型描述
ailabapi-api-key是string应用 API KEY。 获取 API KEY

​
请求体参数

​
固定字段

字段必填类型选项默认描述
task_type是stringasync-任务类型。 async: 异步任务。
auto是integer11模式。 1: 自动模式。
image是file--主图片。
hair_style是string查看选项-发型选择。
color否string查看选项-发色选择。
image_size否integer1, 2, 3, 41返回图片数量。

​
发型选项

  • 男性发型
  • 女性发型
  • 发色
值描述
TinfoilPerm锡纸烫
Chestnut栗子头
ChoppyBangs碎盖刘海
SlickBack背头
BuzzCut寸头
CurlyShag凌乱卷发
UnderCut削边
WavyShag波浪卷发
LowFade低切
ManGreased男士油头
FauxHawk伪莫霍克发型
HighTightFade高渐变发型
Comma_Hair蓬松分头
Korean_Wavy_Crop韩式波浪分
Smooth_Crop齐刘海
Natural_Middle_Part自然中分
Side-Part_Crop商务侧分
FreshSide-Parted清新侧分
FluffyMiddlePart蓬松中分
Natural_Side-Part自然微分
Wolf_Crop美式前刺
Wind-Tousled_Crop明星三七分
Side-Parted_Textured韩式碎盖
WavyMiddlePart烫发中分

​
响应

响应字段处理流程
  1. 处理公共响应字段 解析并验证公共响应字段，检查状态码或响应消息以确保请求成功且无错误。
  2. 处理业务响应字段 如果公共响应字段有效且无错误，则继续处理业务响应字段中的业务逻辑。

​
公共响应字段

查看公共响应字段和错误代码

​
业务响应字段

字段类型选项描述
task_typestringasync任务类型。 async: 异步任务。
task_idstring-异步任务ID。调用查询异步任务结果 API 时使用此字段。

​
响应示例

{
  "request_id": "",
  "log_id": "",
  "error_code": 0,
  "error_msg": "",
  "error_detail": {
    "status_code": 200,
    "code": "",
    "code_message": "",
    "message": ""
  },
  "task_type": "",
  "task_id": ""
}

Authorizations

​
ailabapi-api-key
string
header
required

API Key for authentication

Body

multipart/form-data
​
image
file
required

Image file for hairstyle editing (PNG/JPG/JPEG). ≤3MB, 200x200~1999x1999.

​
hair_style
enum<string>
required

Hairstyle code

Available options:
TinfoilPerm,
Chestnut,
ChoppyBangs,
SlickBack,
BuzzCut,
CurlyShag,
UnderCut,
WavyShag,
LowFade,
ManGreased,
FauxHawk,
HighTightFade,
Comma_Hair,
Korean_Wavy_Crop,
Smooth_Crop,
Natural_Middle_Part,
Side-Part_Crop,
FreshSide-Parted,
FluffyMiddlePart,
Natural_Side-Part,
Wolf_Crop,
Wind-Tousled_Crop,
Side-Parted_Textured,
WavyMiddlePart,
ShortCurlyPixie,
JapaneseShort,
MediumLongLayered,
ShortNeatBob,
DoubleBun,
PixieCut,
LongHimeCut,
BobCut,
CurlyBob,
LongCurly,
LongWavy,
FishtailBraid,
ShortPixieWithShavedSides,
Updo,
BluntBowlCut,
Chignon,
SlickedBack,
StackedCurlsInShortBob,
WavyFrenchBobVibesfrom1920,
ShortTwintails,
LongStraight,
TwinBraids,
Ponytail,
LongTwintails,
BoxBraids,
FrenchBangs,
ShoulderLengthHair,
Side-Parted_Waves,
Magic_Perm,
Vintage_Curls,
Mushroom_Curl,
Textured_Crop,
Side_Flip_Perm,
Layered_Waves
​
color
enum<string>
required

Color (optional).

Available options:
blonde,
platinumBlonde,
brown,
lightBrown,
blue,
lightBlue,
purple,
lightPurple,
pink,
black,
white,
grey,
silver,
red,
orange,
green,
gradient,
multicolored,
darkBlue,
burgundy,
darkGreen
​
image_size
enum<integer> | null
required

Returns the number of images. Default 1.

Available options:
1,
2,
3,
4
​
task_type
enum<string>
default:async
required

Task Type. async: Asynchronous task.

Available options:
async

Response

Success

​
request_id
string

Request ID

​
log_id
string

Log ID

​
error_code
integer

Status code (0 for success)

​
error_msg
string

Error message

​
error_detail
object
​
task_id
string

Task ID for async processing

​
result
string[]

Array of result image URLs

Result image URL