{
  "workflow_id": "four_grid_eyebrow_style_design",
  "input": {
    "img": {
      "field_name": "img",
      "default": "",
      "description": "用户上传的正面照片（支持标准 Base64 编码字符串或普通 URL）",
      "example": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_a7c48b97-edea-499a-a82d-550a919da685.jpg",
      "required": true,
      "type": "base64"
    },
    "prompt": {
      "field_name": "prompt",
      "default": "",
      "description": "可选的提示词参考建议，用于指引眉形设计风格（仅供参考，不强制覆盖）",
      "required": false,
      "type": "string"
    },
    "aspect_ratio": {
      "field_name": "aspect_ratio",
      "default": "1:1",
      "description": "生成图像的宽高比，可选值：1:1、3:4、4:3、16:9、9:16",
      "example": "1:1",
      "required": false,
      "type": "string"
    }
  },
  "steps": [
    {
      "point_code": "1",
      "id": "step_0_prompt_guardian",
      "api_code": "prompt_guardian",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "合规校验优化",
      "action": "run",
      "params": []
    },
    {
      "point_code": "1",
      "id": "step_1_face_analyze",
      "result": [],
      "api_code": "face_visual_analyze",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "面部视觉特征深度分析",
      "action": "run",
      "params": {
        "merge_context": {
          "upstream_content": "",
          "fusion_strategy": "semantic"
        },
        "img_list": [
          {
            "url": "{{@input.img}}"
          }
        ],
        "user_prompt": "深度分析图中人物的正面面部特征：1.脸型（圆脸/方脸/长脸/瓜子脸等）；2.五官比例（眼距、鼻长、嘴宽等）；3.肤色与肤质（冷白皮/暖黄皮/橄榄皮等）；4.原有眉形特征（粗细、长短、弯直、颜色）；5.提取用于保持人物一致性的关键英文关键词（如face shape, skin tone, facial proportions等）。输出必须结构化、专业、详尽。"
      }
    },
    {
      "point_code": "1",
      "id": "step_2_eyebrow_design",
      "result": [],
      "api_code": "eyebrow_style_design",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "4种差异化眉形风格设计",
      "action": "run",
      "params": {
        "merge_context": {
          "upstream_content": "{{@step_1_face_analyze.result.data.structured_analysis}}",
          "fusion_strategy": "semantic"
        },
        "original_eyebrow": "{{@step_1_face_analyze.result.data.structured_analysis.entities.3.value}}",
        "face_shape": "{{@step_1_face_analyze.result.data.structured_analysis.entities.1.value}}",
        "face_features": "{{@step_1_face_analyze.result.data.result}}",
        "user_prompt_hint": "{{@input.prompt}}"
      },
      "depends_on": [
        "step_1_face_analyze"
      ]
    },
    {
      "point_code": "1",
      "id": "step_3_grid_synthesize",
      "result": [],
      "api_code": "grid_prompt_synthesize",
      "backend_type": "prompt_api",
      "status": "PENDING",
      "name": "4宫格排版指令与一致性提示词合成",
      "action": "run",
      "params": {
        "merge_context": {
          "upstream_content": "{{@step_1_face_analyze.result.data.result}}",
          "fusion_strategy": "structural"
        },
        "consistency_keywords": "{{@step_1_face_analyze.result.data.structured_analysis.keywords}}",
        "eyebrow_prompts": [
          {
            "content": "{{@step_2_eyebrow_design.result.data.content_variants.1.content}}",
            "style": "{{@step_2_eyebrow_design.result.data.content_variants.1.style}}",
            "variant_id": "style_1"
          },
          {
            "content": "{{@step_2_eyebrow_design.result.data.content_variants.2.content}}",
            "style": "{{@step_2_eyebrow_design.result.data.content_variants.2.style}}",
            "variant_id": "style_2"
          },
          {
            "content": "{{@step_2_eyebrow_design.result.data.content_variants.3.content}}",
            "style": "{{@step_2_eyebrow_design.result.data.content_variants.3.style}}",
            "variant_id": "style_3"
          },
          {
            "content": "{{@step_2_eyebrow_design.result.data.content_variants.4.content}}",
            "style": "{{@step_2_eyebrow_design.result.data.content_variants.4.style}}",
            "variant_id": "style_4"
          }
        ],
        "user_prompt_hint": "{{@input.prompt}}"
      },
      "depends_on": [
        "step_1_face_analyze",
        "step_2_eyebrow_design"
      ]
    },
    {
      "point_code": "1",
      "id": "step_4_generate_image",
      "result": [],
      "api_code": "3373",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "生成4宫格眉形效果图",
      "action": "run",
      "params": {
        "referImages": [
          "{{@input.img}}"
        ],
        "prompt": "{{@step_3_grid_synthesize.result.data.final_grid_prompt}}",
        "aspect_ratio": "{{@input.aspect_ratio}}"
      },
      "depends_on": [
        "step_3_grid_synthesize"
      ]
    },
    {
      "point_code": "",
      "id": "step_5_poll_image_status",
      "result": [],
      "api_code": "polling",
      "backend_type": "sys_api",
      "status": "PENDING",
      "name": "轮询4宫格效果图生成状态",
      "action": "run",
      "params": {
        "result_url": "{{@step_4_generate_image.result.data.result_url}}"
      },
      "depends_on": [
        "step_4_generate_image"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1200,
        "success_condition": "{{@step_5_poll_image_status.result.data.task_status}} === 'SUCCEEDED'"
      }
    }
  ],
  "output": {
    "result_url": {
      "field_name": "result_url",
      "description": "最终生成的4宫格眉形效果图URL",
      "value": "{{@step_5_poll_image_status.result.data.result_url}}",
      "type": "string"
    },
    "face_analysis": {
      "field_name": "face_analysis",
      "description": "面部视觉特征分析核心总结",
      "value": "{{@step_1_face_analyze.result.data.result}}",
      "type": "string"
    },
    "eyebrow_styles": {
      "field_name": "eyebrow_styles",
      "description": "4种差异化眉形风格设计总结",
      "value": "{{@step_2_eyebrow_design.result.data.result}}",
      "type": "string"
    }
  }
}

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

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

输入参数共 3 个参数（其中 1 个必填）

img必填base64

用户上传的正面照片（支持标准 Base64 编码字符串或普通 URL）

promptstring

可选的提示词参考建议，用于指引眉形设计风格（仅供参考，不强制覆盖）

aspect_ratiostring

生成图像的宽高比，可选值：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/6a5f12e23c51f2474700c6eb?appKey={AppKey}

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

请求体参数 (Request Body)

imgbase64必填

用户上传的正面照片（支持标准 Base64 编码字符串或普通 URL）

promptstring

可选的提示词参考建议，用于指引眉形设计风格（仅供参考，不强制覆盖）

aspect_ratiostring

生成图像的宽高比，可选值：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/6a5f12e23c51f2474700c6eb?appKey={AppKey}

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

curl \
  -g 'https://route.showapi.com/flow/execute/6a5f12e23c51f2474700c6eb?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "img": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_a7c48b97-edea-499a-a82d-550a919da685.jpg",
  "prompt": "",
  "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/6a5f12e23c51f2474700c6eb.yaml

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