首页 API市场大模型广场

AI Skills

AI应用创作

其他产品

产品价格

市场|导航

控制台

充值通用资源包

AI妆造指导

上传素颜照片与妆造主题，通过面部特征深度分析生成最多9步定制化化妆步骤，基于步骤生成包含关键部位标注与中文说明的9宫格指导图，同时结合面部特征保持人物一致性生成最终妆造效果图，最终逻辑融合交付完整结果。

Serenoa 2026-07-24 15:54 · 10 个步骤

能力组成

输出案例

1合规校验优化

2素颜面部特征深度分析

3妆造步骤专业规划

49宫格指导图提示词构建

5效果图提示词构建

6异步生成9宫格指导图

7轮询9宫格指导图生成状态

8异步生成效果图

9轮询效果图生成状态

10妆造结果融合输出

完整定义 (JSON)251 行

{
  "workflow_id": "makeup_guide_and_effect_generation",
  "input": {
    "img": {
      "field_name": "img",
      "default": "",
      "description": "素颜人脸照片（传入标准 Base64 编码字符串或普通 URL）",
      "example": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_497f596a-e226-45c6-994a-0544f59a3914.jpg",
      "type": "base64",
      "required": true
    },
    "makeup_prompt": {
      "field_name": "makeup_prompt",
      "default": "清冷感亚裔妆",
      "description": "妆造主题提示词",
      "example": "新娘妆",
      "type": "string",
      "required": true
    },
    "effect_aspect_ratio": {
      "field_name": "effect_aspect_ratio",
      "default": "3:4",
      "description": "效果图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）",
      "example": "1:1",
      "type": "string",
      "required": false
    },
    "guide_aspect_ratio": {
      "field_name": "guide_aspect_ratio",
      "default": "1:1",
      "description": "9宫格指导图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）",
      "example": "1:1",
      "type": "string",
      "required": false
    }
  },
  "steps": [
    {
      "id": "step_0_prompt_guardian",
      "point_code": "1",
      "api_code": "prompt_guardian",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "合规校验优化",
      "action": "run",
      "params": []
    },
    {
      "point_code": "",
      "id": "step_1_face_feature_analyzer",
      "result": [],
      "api_code": "face_feature_analyzer",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "素颜面部特征深度分析",
      "action": "run",
      "params": {
        "img_list": [
          {
            "url": "{{@input.img}}"
          }
        ],
        "user_prompt": "深度分析图中素颜人脸特征：1)肤质与肤色基调 2)脸型轮廓 3)五官比例与特点(眼/眉/鼻/唇/颧骨) 4)现有皮肤问题(痘/斑/黑眼圈)"
      }
    },
    {
      "point_code": "",
      "id": "step_2_makeup_step_planner",
      "result": [],
      "api_code": "makeup_step_planner",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "妆造步骤专业规划",
      "action": "run",
      "params": {
        "makeup_prompt": "{{@input.makeup_prompt}}",
        "face_features": "{{@step_1_face_feature_analyzer.result.data.result}}"
      },
      "depends_on": [
        "step_1_face_feature_analyzer"
      ]
    },
    {
      "point_code": "",
      "id": "step_3_guide_grid_prompt_builder",
      "result": [],
      "api_code": "guide_grid_prompt_builder",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "9宫格指导图提示词构建",
      "action": "run",
      "params": {
        "makeup_steps": "{{@step_2_makeup_step_planner.result.data.structured_analysis.steps}}"
      },
      "depends_on": [
        "step_2_makeup_step_planner"
      ]
    },
    {
      "point_code": "",
      "id": "step_4_effect_prompt_builder",
      "result": [],
      "api_code": "effect_prompt_builder",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "效果图提示词构建",
      "action": "run",
      "params": {
        "makeup_prompt": "{{@input.makeup_prompt}}",
        "face_features": "{{@step_1_face_feature_analyzer.result.data.result}}"
      },
      "depends_on": [
        "step_1_face_feature_analyzer"
      ]
    },
    {
      "point_code": "1",
      "id": "step_5_generate_guide_image",
      "result": [],
      "api_code": "3373",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "异步生成9宫格指导图",
      "action": "run",
      "params": {
        "referImages": [
          "{{@input.img}}"
        ],
        "prompt": "{{@step_3_guide_grid_prompt_builder.result.data.result}}",
        "aspect_ratio": "{{@input.guide_aspect_ratio}}"
      },
      "depends_on": [
        "step_3_guide_grid_prompt_builder"
      ]
    },
    {
      "id": "step_6_poll_guide_image",
      "point_code": "",
      "result": [],
      "api_code": "polling",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "轮询9宫格指导图生成状态",
      "action": "run",
      "params": {
        "result_url": "{{@step_5_generate_guide_image.result.data.result_url}}"
      },
      "depends_on": [
        "step_5_generate_guide_image"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1200,
        "success_condition": "{{@step_6_poll_guide_image.result.data.task_status}} === 'SUCCEEDED'"
      }
    },
    {
      "point_code": "1",
      "id": "step_7_generate_effect_image",
      "result": [],
      "api_code": "3373",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "异步生成效果图",
      "action": "run",
      "params": {
        "referImages": [
          "{{@input.img}}"
        ],
        "prompt": "{{@step_4_effect_prompt_builder.result.data.result}}",
        "aspect_ratio": "{{@input.effect_aspect_ratio}}"
      },
      "depends_on": [
        "step_4_effect_prompt_builder"
      ]
    },
    {
      "id": "step_8_poll_effect_image",
      "point_code": "",
      "result": [],
      "api_code": "polling",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "轮询效果图生成状态",
      "action": "run",
      "params": {
        "result_url": "{{@step_7_generate_effect_image.result.data.result_url}}"
      },
      "depends_on": [
        "step_7_generate_effect_image"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1200,
        "success_condition": "{{@step_8_poll_effect_image.result.data.task_status}} === 'SUCCEEDED'"
      }
    },
    {
      "point_code": "",
      "id": "step_9_content_merge",
      "result": [],
      "api_code": "content_merge",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "妆造结果融合输出",
      "action": "run",
      "params": {
        "guide_image_url": "{{@step_6_poll_guide_image.result.data.result_url}}",
        "makeup_steps": "{{@step_2_makeup_step_planner.result.data.structured_analysis}}",
        "effect_image_url": "{{@step_8_poll_effect_image.result.data.result_url}}"
      },
      "depends_on": [
        "step_2_makeup_step_planner",
        "step_6_poll_guide_image",
        "step_8_poll_effect_image"
      ]
    }
  ],
  "output": {
    "guide_image_url": {
      "field_name": "guide_image_url",
      "description": "9宫格指导图URL",
      "value": "{{@step_6_poll_guide_image.result.data.result_url}}",
      "type": "string"
    },
    "final_result": {
      "field_name": "final_result",
      "description": "融合后的最终结构化响应（包含完整步骤列表、图片URL、妆造建议）",
      "value": "{{@step_9_content_merge.result.data.result}}",
      "type": "object"
    },
    "makeup_steps": {
      "field_name": "makeup_steps",
      "description": "定制化化妆步骤列表（最多9步）",
      "value": "{{@step_2_makeup_step_planner.result.data.structured_analysis.steps}}",
      "type": "array"
    },
    "face_features": {
      "field_name": "face_features",
      "description": "面部特征深度分析结果",
      "value": "{{@step_1_face_feature_analyzer.result.data.result}}",
      "type": "string"
    },
    "effect_image_url": {
      "field_name": "effect_image_url",
      "description": "妆造效果图URL",
      "value": "{{@step_8_poll_effect_image.result.data.result_url}}",
      "type": "string"
    }
  }
}

调用方式异步 https://route.showapi.com/flow/execute/6a63152d3c51f2e65901273d

提交后立即返回 task_id，系统每 2 秒自动轮询一次运行状态并可视化执行步骤，适合耗时较长的 Skill。

输入参数共 4 个参数（其中 2 个必填）

img必填base64

素颜人脸照片（传入标准 Base64 编码字符串或普通 URL）

makeup_prompt必填string

妆造主题提示词

effect_aspect_ratiostring

效果图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）

guide_aspect_ratiostring

9宫格指导图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）

把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Skill 技能包。

Skill 为异步调用过程：先提交执行拿到 task_id，再轮询查询任务状态与结果。下方按调用顺序列出两个端点。

1POST

提交执行

https://route.showapi.com/flow/execute/6a63152d3c51f2e65901273d?appKey={AppKey}

鉴权：URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey

请求体参数 (Request Body)

imgbase64必填

素颜人脸照片（传入标准 Base64 编码字符串或普通 URL）

makeup_promptstring必填

妆造主题提示词

effect_aspect_ratiostring

效果图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）

guide_aspect_ratiostring

9宫格指导图宽高比（可选值：1:1, 3:4, 4:3, 16:9, 9:16）

响应：提交成功返回 task_id

2GET

查询任务状态

https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}

鉴权：URL 查询参数 appKey={AppKey}Content-Type: application/json获取 AppKey

用第 ① 步返回的 task_id 替换 URL 中的 {task_id} 轮询，建议 1-2 秒一次，直到 status 为 SUCCESS 或 FAILED；step_status_list 可用于可视化执行进度。

响应：任务状态与结果

执行中途出错时

status 返回 FAILED， remark 给出错误信息； step_status_list 仅包含已执行到的部分阶段， output 为已产出的部分结果（可能为空或不完整）。

通用响应说明

系统级返回

所有 API 响应均使用平台统一封装，业务数据嵌套在 showapi_res_body 中

错误码 (showapi_res_code)

调用代码

代码示例根据当前 输入参数实时生成。异步调用一并提供"执行"与"查询任务"两个步骤的完整代码，可按序集成。

调用代码

POSThttps://route.showapi.com/flow/execute/6a63152d3c51f2e65901273d?appKey={AppKey}

提交任务后立即返回 task_id，需配合步骤 ② 轮询执行状态与结果

curl \
  -g 'https://route.showapi.com/flow/execute/6a63152d3c51f2e65901273d?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "img": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_497f596a-e226-45c6-994a-0544f59a3914.jpg",
  "makeup_prompt": "新娘妆",
  "effect_aspect_ratio": "1:1",
  "guide_aspect_ratio": "1:1"
}'

响应示例：{ "code": 0, "data": { "task_id": "69ddd187e13823d1d500015b" } }

请在 URL 查询参数 appKey 中携带你的 AppKey（如 ?appKey=你的AppKey），不要在前端代码中硬编码生产凭证，建议通过环境变量或后端代理注入。前往控制台获取 AppKey

OpenAPI 规范

标准 OpenAPI 3.0 规范文档，可导入 Apifox / Postman / Swagger Editor / Dify，或直接交给 AI Agent 读取以自动接入本 Skill。提供 YAML 与 JSON 两种格式，支持浏览器在线查看与直接下载。
当前为已发布正式版（/flow/*，对外可调用）。

YAMLhttp://node_site_upstream/openapi/workflow/6a63152d3c51f2e65901273d.yaml

JSONhttp://node_site_upstream/openapi/workflow/6a63152d3c51f2e65901273d.json