{
  "workflow_id": "ai_fashion_editorial_generator",
  "input": {
    "img_url": {
      "field_name": "img_url",
      "default": "",
      "description": "源人物照片URL或Base64编码字符串，用于深度面部特征与气质提取，保证生成大片人脸一致性",
      "example": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_7dec0a72-d84d-4cad-8419-c59aab447b4c.jpg",
      "required": true,
      "type": "base64"
    },
    "theme": {
      "field_name": "theme",
      "default": "",
      "description": "时尚主题概念列表，以逗号或换行分隔。可为空或不足9个，系统将基于人物气质自动补全或裂变至9个差异化先锋概念",
      "example": "图1：时间会证明光模块\n图2：有枣没枣搂一杆子\n图3：小be 一会儿\n图4：独立学者\n图5：这不是好事吗\n图6：百年压抑\n图7：狡兔三窟\n图8：中流砥柱\n图9：东南西北旋风财",
      "required": false,
      "type": "string"
    },
    "aspect_ratio": {
      "field_name": "aspect_ratio",
      "default": "9:16",
      "description": "生成图像的宽高比，可选值：1:1, 3:4, 4:3, 16:9, 9:16",
      "example": "1:1",
      "required": false,
      "type": "string"
    }
  },
  "steps": [
    {
      "id": "step_0_prompt_guardian",
      "point_code": "1",
      "backend_type": "sys_api",
      "api_code": "prompt_guardian",
      "status": "PENDING",
      "name": "合规校验优化",
      "action": "run",
      "params": []
    },
    {
      "point_code": "1",
      "id": "step_1_intent_analyzer",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "intent_analyzer",
      "status": "PENDING",
      "name": "解析时尚大片创意意图与调度指令",
      "action": "run",
      "params": {
        "img_url": "{{@input.img_url}}",
        "theme": "{{@input.theme}}"
      }
    },
    {
      "point_code": "1",
      "id": "step_2_face_feature_extractor",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "face_feature_extractor",
      "status": "PENDING",
      "name": "提取源人物面部特征与气质标签",
      "action": "run",
      "params": {
        "merge_context": {
          "fusion_strategy": "semantic",
          "upstream_content": "{{@step_1_intent_analyzer.result.data.result}}",
          "priority_rules": [
            "Face ID一致性 > 戏剧张力 > 画质参数"
          ]
        },
        "img_list": [
          {
            "url": "{{@input.img_url}}"
          }
        ],
        "user_prompt": "深度分析图中人物的面部骨骼结构（颧骨高低、下颌线条）、五官比例（眼距、鼻长、唇形）、发型特征及核心气质标签，给出结构化特征描述，特别提取可用于保证人脸一致性的关键锚点特征。"
      },
      "depends_on": [
        "step_1_intent_analyzer"
      ]
    },
    {
      "point_code": "1",
      "id": "step_3_theme_visual_deconstruct",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "theme_visual_deconstruct",
      "status": "PENDING",
      "name": "裂变9个时尚主题为具象视觉执行方案",
      "action": "run",
      "params": {
        "merge_context": {
          "fusion_strategy": "semantic",
          "upstream_content": "{{@step_1_intent_analyzer.result.data.result}}",
          "priority_rules": [
            "视觉张力优先，气质作为内在基调微调"
          ]
        },
        "temperament_tags": "{{@step_2_face_feature_extractor.result.data.temperament_tags}}",
        "theme_concepts": "{{@step_1_intent_analyzer.result.data.theme_concepts}}"
      },
      "depends_on": [
        "step_1_intent_analyzer",
        "step_2_face_feature_extractor"
      ]
    },
    {
      "point_code": "1",
      "id": "step_4_fashion_prompt_synthesizer",
      "result": [],
      "backend_type": "prompt_api",
      "api_code": "fashion_prompt_synthesizer",
      "status": "PENDING",
      "name": "合成9个高质量英文时尚大片生图Prompt",
      "action": "run",
      "params": {
        "merge_context": {
          "fusion_strategy": "semantic/structural/stylistic",
          "upstream_content": "{{@step_3_theme_visual_deconstruct.result.data.result}}",
          "priority_rules": [
            "Face ID一致性 > 戏剧张力 > 画质参数"
          ]
        },
        "visual_plans": "{{@step_3_theme_visual_deconstruct.result.data.visual_plans}}",
        "consistency_anchor": "{{@step_2_face_feature_extractor.result.data.consistency_anchor}}",
        "face_features": "{{@step_2_face_feature_extractor.result.data.face_features}}"
      },
      "depends_on": [
        "step_2_face_feature_extractor",
        "step_3_theme_visual_deconstruct"
      ]
    },
    {
      "result": [],
      "iterator": "{{@step_4_fashion_prompt_synthesizer.result.data.prompts}}",
      "status": "PENDING",
      "aggregates": [
        {
          "field": "data.result_url",
          "into": "image_urls"
        },
        {
          "field": "data.task_id",
          "into": "task_ids"
        }
      ],
      "params": {
        "prompt": "{{@prompt_item.prompt_content}}",
        "aspect_ratio": "{{@input.aspect_ratio}}"
      },
      "depends_on": [
        "step_4_fashion_prompt_synthesizer"
      ],
      "id": "step_5_generate_images",
      "point_code": "1",
      "backend_type": "sys_api",
      "api_code": "3373",
      "item_name": "prompt_item",
      "name": "循环生成9张先锋时尚大片图像",
      "action": "foreach"
    },
    {
      "result": [],
      "iterator": "{{@step_5_generate_images.result.data.aggregated.image_urls}}",
      "status": "PENDING",
      "aggregates": [
        {
          "field": "data.result_url",
          "into": "final_image_urls"
        },
        {
          "field": "data.task_status",
          "into": "final_task_statuses"
        }
      ],
      "params": {
        "result_url": "{{@image_url_item}}"
      },
      "depends_on": [
        "step_5_generate_images"
      ],
      "polling": {
        "interval_seconds": 5,
        "timeout_seconds": 1800,
        "success_condition": "{{@step_6_poll_images.result.data.task_status}} === 'SUCCEEDED'"
      },
      "id": "step_6_poll_images",
      "point_code": "",
      "api_code": "polling",
      "backend_type": "sys_api",
      "item_name": "image_url_item",
      "name": "轮询9张图像生成状态",
      "action": "foreach"
    }
  ],
  "output": {
    "final_task_statuses": {
      "field_name": "final_task_statuses",
      "description": "9张图像对应的最终任务状态数组",
      "value": "{{@step_6_poll_images.result.data.aggregated.final_task_statuses}}",
      "type": "array"
    },
    "final_image_urls": {
      "field_name": "final_image_urls",
      "description": "9张生成的先锋时尚大片最终图像URL数组",
      "value": "{{@step_6_poll_images.result.data.aggregated.final_image_urls}}",
      "type": "array"
    },
    "temperament_tags": {
      "field_name": "temperament_tags",
      "description": "源人物核心气质标签列表",
      "value": "{{@step_2_face_feature_extractor.result.data.temperament_tags}}",
      "type": "array"
    },
    "consistency_anchor": {
      "field_name": "consistency_anchor",
      "description": "提取的人脸一致性关键锚点特征组合描述",
      "value": "{{@step_2_face_feature_extractor.result.data.consistency_anchor}}",
      "type": "string"
    },
    "theme_concepts": {
      "field_name": "theme_concepts",
      "description": "解析或补全后的9个时尚主题概念列表",
      "value": "{{@step_1_intent_analyzer.result.data.theme_concepts}}",
      "type": "array"
    }
  }
}

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

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

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

img_url必填base64

源人物照片URL或Base64编码字符串，用于深度面部特征与气质提取，保证生成大片人脸一致性

themestring

时尚主题概念列表，以逗号或换行分隔。可为空或不足9个，系统将基于人物气质自动补全或裂变至9个差异化先锋概念

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/6a5f12843c51f2474700c52b?appKey={AppKey}

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

请求体参数 (Request Body)

img_urlbase64必填

源人物照片URL或Base64编码字符串，用于深度面部特征与气质提取，保证生成大片人脸一致性

themestring

时尚主题概念列表，以逗号或换行分隔。可为空或不足9个，系统将基于人物气质自动补全或裂变至9个差异化先锋概念

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/6a5f12843c51f2474700c52b?appKey={AppKey}

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

curl \
  -g 'https://route.showapi.com/flow/execute/6a5f12843c51f2474700c52b?appKey={AppKey}' \
  -H 'Content-Type: application/json' \
  -d '{
  "img_url": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_7dec0a72-d84d-4cad-8419-c59aab447b4c.jpg",
  "theme": "图1：时间会证明光模块\n图2：有枣没枣搂一杆子\n图3：小be 一会儿\n图4：独立学者\n图5：这不是好事吗\n图6：百年压抑\n图7：狡兔三窟\n图8：中流砥柱\n图9：东南西北旋风财",
  "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/6a5f12843c51f2474700c52b.yaml

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