发型编辑 API

请求

URL: /portrait/effects/hairstyle-editor-pro
方法: POST
Content-Type: multipart/form-data

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

图片要求

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

有效性	示例图片	无效原因
✅		有效
❌		不包含人脸
		面部不完整
		面部被遮挡
		面部比例过小
		面部比例过大

请求头

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

请求体参数

固定字段

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

发型选项

男性发型
女性发型
发色

值	描述
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	波浪卷发 (女)

值	描述
`blonde`	金发
`platinumBlonde`	白金金发
`brown`	棕发
`lightBrown`	浅棕发
`blue`	蓝发
`lightBlue`	浅蓝发
`purple`	紫发
`lightPurple`	浅紫发
`pink`	粉发
`black`	黑发
`white`	白发
`grey`	灰发
`silver`	银发
`red`	红发
`orange`	橙发
`green`	绿发
`gradient`	渐变发
`multicolored`	彩色发
`darkBlue`	深蓝发
`burgundy`	酒红发
`darkGreen`	深绿发

响应

响应字段处理流程

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

公共响应字段

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

业务响应字段

字段	类型	选项	描述
`task_type`	`string`	`async`	任务类型。 `async`: 异步任务。
`task_id`	`string`	-	异步任务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

Show child attributes

task_id

string

Task ID for async processing

result

string[]

Array of result image URLs

Result image URL

开始使用

产品介绍

开发指南

API参考

其他

请求

图片要求

请求头

请求体参数

固定字段

发型选项

响应

公共响应字段

业务响应字段

响应示例

Authorizations

Body

Response

开始使用

产品介绍

开发指南

API参考

其他

​请求

​图片要求

​请求头

​请求体参数

​固定字段

​发型选项

​响应

​公共响应字段

​业务响应字段

​响应示例

Authorizations

Body

Response

请求

图片要求

请求头

请求体参数

固定字段

发型选项

响应

公共响应字段

业务响应字段

响应示例