ai-beauty Skill#

Beautify faces or portraits in an image according to user's instructions.

AI智能人像美颜技能，让照片里的你光彩动人 全程本地处理您的照片，不上传到任何服务器，安全放心有保障 处理速度快，效果不满意可通过多轮对话调节，不用抽卡 限时免费使用，登录官网 https://www.aicodingyard.com 申请token_key即可免费使用，开通vip可不限量使用 还有若干高端功能待您发掘，可联系官方客服获取

Token Configuration#

This skill requires a valid BITSOUL_TOKEN to function properly. You can register and apply for a token for free at https://www.aicodingyard.com, and configure it in your external runtime environment.

Required Environment Variables#

• BITSOUL_TOKEN: User token used for remote server permission verification.

Optional Environment Variables#

• BITSOUL_TOKEN_ENV_FILE: Points to the env file containing BITSOUL_TOKEN.

Configuration Methods#

1. Method 1: Set environment variable directly bash

   export BITSOUL_TOKEN="your_token_here"
   
   

2. Method 2: Use env file bash

   export BITSOUL_TOKEN_ENV_FILE="/path/to/token.env"
   
   

   The content format of token.env file should be: text

   BITSOUL_TOKEN=your_token_here
   
   

Note: If both the environment variable and env file are set, the environment variable takes precedence.

Installation and Initialization#

Before using the skill, ensure that python and requests are installed. For the first time use, an initialization operation is required. After setting up the BITSOUL_TOKEN, run the initialization script to download the necessary binary file:

bash

python ./BitSoulFaceBeautySkill/init.py

Instructions#

Execute the following procedures step by step each time an image is processed:

1. Run the initialization script init.py
2. Get the image path to be beautified.
3. Ask the user to make a choice among the recommended parameters files and obtain specific beautification requirements.
4. Generate a temporary beauty parameters file (json format).
5. Create a new directory in the image path to be beautified and save all results into this new directory.
6. Run tool.

shell

./BitSoulFaceBeautySkill/BitSoulBeauty.exe BITSOUL_TOKEN IMAGE_PATH_TO_BE_BEAUTIFIED BEAUTY_PARAMETERS_FILE_PATH IMAGE_PATH_TO_BE_SAVED

you must call init.py before you use any functions in this skill.

Beauty Parameters File#

There are three recommended parameters files.

1. 自然（默认）

json

{
    "磨皮":0.5,
    "清晰":0.2,
    "白牙":0.4,
    "亮眼":0.3,
    "美白-自然":0.3,
    "祛黑眼圈":0.5,
    "祛法令纹":0.3,
    "自然脸":0.4,
    "女神":0.0,
    "男神":0.0,
    "小头":0.3,
    "小脸":0.3,
    "窄脸":0.3,
    "瘦下巴":0.0,
    "瘦颧骨":0.2,
    "瘦下颌":0.2,
    "眼睛位置":0.0,
    "眼距":0.0,
    "大眼":0.3,
    "瘦鼻":0.4,
    "长鼻":0.0,
    "嘴巴位置":0.0,
    "嘴巴大小":0.0,
    "美胯":0.0,
    "天鹅颈":0.0,
    "丰胸":0.0,
    "瘦腰":0.0,
    "长腿":0.0,
    "瘦腿":0.0,
    "瘦手臂":0.0,
    "瘦身":0.0,
    "发际线":0.0,
    "双眼皮":0.0,
    "默认妆容":0.5,
    "默认妆容_lut":0.5
}

2.精致

json

{
    "磨皮":0.8,
    "清晰":0.2,
    "白牙":0.4,
    "亮眼":0.5,
    "美白-白皙":0.5,
    "祛黑眼圈":0.7,
    "祛法令纹":0.7,
    "自然脸":0.0,
    "女神":0.7,
    "男神":0.0,
    "小头":0.0,
    "小脸":0.0,
    "窄脸":0.15,
    "瘦下巴":0.0,
    "瘦颧骨":0.3,
    "瘦下颌":0.2,
    "眼睛位置":0.0,
    "眼距":0.0,
    "大眼":0.6,
    "瘦鼻":0.6,
    "长鼻":0.0,
    "嘴巴位置":0.0,
    "嘴巴大小":0.0,
    "美胯":0.0,
    "天鹅颈":0.0,
    "丰胸":0.0,
    "瘦腰":0.0,
    "长腿":0.0,
    "瘦腿":0.0,
    "瘦手臂":0.0,
    "瘦身":0.0,
    "发际线":0.2,
    "双眼皮":0.0,
    "女神妆":0.7,
    "女神妆_lut":0.7
}

3.减龄

json

{
    "磨皮":0.9,
    "清晰":0.2,
    "白牙":0.4,
    "亮眼":0.5,
    "美白-红润":0.5,
    "祛黑眼圈":0.9,
    "祛法令纹":0.9,
    "自然脸":0.75,
    "女神":0.0,
    "男神":0.0,
    "小头":0.0,
    "小脸":0.4,
    "窄脸":0.3,
    "瘦下巴":0.0,
    "瘦颧骨":0.3,
    "瘦下颌":0.2,
    "眼睛位置":0.0,
    "眼距":0.0,
    "大眼":0.8,
    "瘦鼻":0.6,
    "长鼻":0.0,
    "嘴巴位置":0.0,
    "嘴巴大小":0.0,
    "美胯":0.0,
    "天鹅颈":0.0,
    "丰胸":0.0,
    "瘦腰":0.0,
    "长腿":0.0,
    "瘦腿":0.0,
    "瘦手臂":0.0,
    "瘦身":0.0,
    "发际线":0.3,
    "双眼皮":0.0,
    "伪素颜":0.7,
    "伪素颜_lut":0.6
}

Beauty Items#

Beauty Parameters File中的 美颜小项 的介绍如下表所示：#

名称功能描述目的触发词汇(想要的效果)问题触发词汇(想解决的痛点)磨皮柔化皮肤表层纹理，智能淡化毛孔、细纹、痘印等瑕疵；磨皮、平滑、光滑、平整、细腻、柔肤、嫩肤、美肤、遮瑕、去瑕疵、护肤、皮肤优化、皮肤处理、去痘、缩毛孔、去黑头、去痘印、去斑、去纹、去油皮肤粗糙、皮肤状态不好，有痘、皮肤油、毛孔大、皮肤差、闭口、粉刺、黑头美白-自然均匀提亮肤色至健康透亮状态，呈现“原生好皮”效果；美白、提亮、变白、调亮、透亮、通透、白皙、亮白、去暗沉、去黑、暖白、自然美白肤色不均匀、显黑、暗沉、肤色黑、肤色脏、肤色深美白-粉白提亮肤色并融入柔和粉调，增强脸颊红润气色；粉白、红润、血色苍白、气色差美白-白皙深度提亮至冷调白皙肤质，弱化暗沉与黄气，呈现通透瓷肌感，突出清冷高级氛围；冷白、雪白、去黄肤色黄清晰增强面部轮廓与五官边缘锐度，强化立体光影，避免画面模糊；清晰，立体、层次、锐化、清楚、去糊糊、朦胧、画面灰、不清楚自然脸收窄下半脸，保留个人骨相特征；瘦脸、脸瘦、推脸、收脸、瓜子脸、鹅蛋脸、小V脸脸大、大脸、圆脸、方脸、国字脸、显胖、咬肌大、发腮、脸胖、肿脸，垮脸，脸盘大女神强化V脸轮廓与下颌线流畅度，搭配柔和颧骨修饰，突出女性柔美气质；女神脸、御姐、精致脸男神保留男性下颌硬朗线条，适度收窄两侧轮廓，突出轮廓感；自然脸、高级脸小脸缩短下半脸长度，缩小下庭的比例；短脸、脸变短、脸缩短、缩下庭、下庭缩短、提下颌、下颌上移、幼态感、减龄、缩短脸型、小比例、可爱、软萌、短脸、娇小感、脸型紧凑、黄金比例、去成熟感、低龄化脸长、脸太长、大长脸、下庭长、下脸长、下颌长、下半脸长、老气、脸太长、长辈脸、显老、脸部比例不平衡、下巴过长小头适度缩小头部整体视觉比例，优化头身比与肩颈线条；小头、头小、头缩小、头弄小、头整小、头搞小、头调小、头收小、头身比、头肩比、头颈比头大、头围大、脑袋大、没脖子、大头、窄脸收缩脸颊两侧轮廓，视觉上缩小脸宽；窄脸、脸窄、脸变窄、脸收窄、收窄脸型、脸型收窄、脸宽收窄、两侧收窄、两边收窄、脸压窄、脸缩窄、脸往里收脸宽、脸扁、宽脸、方脸、胖脸发际线调整发际线高低，优化额头比例，正向为压低，负向为提高；正：发际线低一点、发际线下来、发际线下移、发际线往前、发际线往下走、发际线压一点、发际线遮一点；负：发际线提升、额头变宽、发际线升高；正：大脑门、发际线高、发际线太高、发际线后移、发际线后退、发际线上移、；负：发际线低、额头窄；瘦颧骨柔化颧骨突出感，收窄颧骨区域宽度，使面部线条更流畅柔和；瘦颧骨、收颧骨、缩颧骨、面部平滑、消灭棱角、脸线条顺、高级脸、削骨感、脸部收紧、磨平骨头、温婉感、面部平顺、自然过渡颧骨高、太阳穴凹陷、面相硬、脸部崎岖、颧骨凸、颧骨大、颧骨突出、颧骨宽、颧骨太高、颧骨太宽、颧骨肥大、颧骨凸出瘦下颌收窄下颌角线条，减小下颌宽度；瘦下颌、下颌线清晰、收紧轮廓、下巴线条、去双下巴、削骨、精致侧脸、紧致感、折叠度、小V脸、上提、立体感、下巴宽、腮帮子大、方脸、肉多、轮廓模糊、没有下颌线、双下巴、咬肌大、侧脸肥、下颌宽大、脸部下垂、方下巴瘦下巴缩小下巴体积与宽度，优化下巴尖度，提升脸型精致度；尖下巴、V字下巴、小尖脸、下巴收一收、精致下巴、蛇精脸（夸张）、瓜子脸、下巴聚拢、收窄下巴、网红尖、下庭收紧下巴圆、下巴钝、下巴肉、短下巴、方下巴、下巴宽、下巴肥、下半脸笨重、下巴平、下巴大、下巴赘肉、下巴肉感、大眼整体放大眼睛；大眼、眼睛放大、眼睛变大、眼睛有神，眼睛扩大，眼睛小、眼睛太小、眼睛无神、眼睛没神、眼睛小眯眯、眼睛不大、眼睛显小、眼睛没精神、眼睛呆滞、眼睛不亮、眼睛不好看、眼睛没灵气眼距缩小两眼的间距；眼距、眼距缩短、眼距协调、眼距优化、眼距修饰、眼距调整、眼距宽、眼距不协调、眼距奇怪、眼距过大、眼距失调、祛黑眼圈淡化黑眼圈，同时填充泪沟凹陷区域；去黑眼圈、遮黑眼圈、淡化黑眼圈、消除黑眼圈、提亮眼下、眼下平整、遮泪沟黑眼圈、眼下不暗沉、改善黑眼圈、去黑眼圈、遮泪沟、填平泪沟熊猫眼、熬夜眼、眼底黑、泪沟深、眼袋重、黑眼圈太明显、眼下发黑双眼皮添加双眼皮效果，增强眼部层次感；变成双眼皮、单变双、割双眼皮亮眼提亮眼睛，增强眼睛通透度；亮眼、眼睛提亮、眼睛更有神、眼部提亮、去红血丝、眼睛清澈、眼睛发光眼睛浑浊、眼睛暗淡、眼神无光、眼睛不亮、眼球浑浊、眼睛无神瘦鼻收窄或扩大鼻部整体宽度，正向为收窄，负向为增宽；正：瘦鼻、鼻子变小、鼻子收窄、鼻子精致、鼻型优化、小翘鼻、鼻子线条流畅、缩鼻、鼻子更立体；负：宽鼻、宽鼻梁、宽鼻翼、鼻子宽、；正：鼻子大、鼻子宽、鼻头大、鼻翼宽、鼻子钝、鼻型粗大；负：鼻子窄、鼻子太窄、鼻子细、鼻子太细；长鼻微调鼻部纵向长度，正向为缩短，负向为拉长；正：缩短鼻子、鼻子变短、长鼻调整、鼻长优化、鼻子不太长、鼻型比例协调、缩短鼻长、调整鼻子长度；负：鼻、长鼻子、长鼻梁、高鼻梁、；正：鼻子太长、鼻子显长；负：鼻子短、鼻梁短、鼻子太短、鼻梁太短、没鼻梁、塌鼻梁、鼻梁塌、；嘴巴大小放大或缩小嘴唇整体尺寸比例，匹配面部协调度，正向为缩小，负向为放大；正：樱桃小嘴、缩唇、小嘴、调整嘴型、嘴巴缩小、嘴巴精致；负：放大嘴巴、嘴巴变大；正：嘴巴大、嘴大、嘴型大；负：嘴巴太小；嘴巴位置调整嘴唇在面部的垂直位置，嘴巴整体上移，优化人中与唇颏关系；嘴巴上移、嘴巴位置向上嘴巴太靠下、嘴巴位置偏下祛法令纹淡化法令纹，优化鼻基底，平滑肌肤，减少年龄感；去法令纹、淡化法令纹、遮法令纹、抚平法令纹、消除法令纹、法令纹平整、面部平整、减龄、填充、去沟壑法令纹深、显老、脸垮、有沟、笑纹重、鼻翼沟深、老态、皮肤下垂、沟壑明显、八字纹、白牙提亮牙齿，去除黄渍暗沉；白牙、牙齿美白、牙齿变白、亮白牙齿、去黄牙、洁牙、牙齿增白、牙齿亮白、牙白一点牙齿黄、牙黄、黄牙

使用“美颜小项”需要遵守的规则#

1.“美白-自然”、“美白-粉白”、“美白-白皙”是互斥的，在同一个参数文件中只能出现一种。