API参考
发型编辑 API
基于稳定扩散模型,支持数十种不同的发型和颜色,每个生成的结果都是独特的。可以同时生成多达四张结果图片,方便比较和选择最合适的发型。
POST
Hairstyle Editor Pro
请求
- URL: /portrait/effects/hairstyle-editor-pro
- 方法:
POST - Content-Type:
multipart/form-data
图片要求
- 图片格式:
PNGJPGJPEG - 图片大小: 不超过3MB。
- 图片分辨率: 大于200x200px,小于1999x1999px。
- 最小面部比例: 为确保效果,图像中面部的比例不能小于20%。
- 面部完整性: 为确保效果,图像中的面部理想情况下不应被遮挡。
- 面部角度: 为确保效果,图像中的面部理想情况下应为正面,向左或向右旋转不超过45度。
| 有效性 | 示例图片 | 无效原因 |
|---|---|---|
| ✅ | ![]() ![]() | 有效 |
| ❌ | ![]() ![]() | 不包含人脸 |
![]() ![]() | 面部不完整 | |
![]() ![]() | 面部被遮挡 | |
![]() ![]() | 面部比例过小 | |
![]() ![]() | 面部比例过大 |
请求头
请求体参数
固定字段
发型选项
- 男性发型
- 女性发型
- 发色
响应
公共响应字段
查看公共响应字段和错误代码业务响应字段
响应示例
Authorizations
API Key for authentication
Body
multipart/form-data
Image file for hairstyle editing (PNG/JPG/JPEG). ≤3MB, 200x200~1999x1999.
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 (optional).
Available options:
blonde, platinumBlonde, brown, lightBrown, blue, lightBlue, purple, lightPurple, pink, black, white, grey, silver, red, orange, green, gradient, multicolored, darkBlue, burgundy, darkGreen Returns the number of images. Default 1.
Available options:
1, 2, 3, 4 Task Type. async: Asynchronous task.
Available options:
async Hairstyle Editor Pro












