创建时间: 2026-07-01 15:35 | 步骤: 9 个
基于用户上传的肖像人像图,提取五官特征保真约束,合规检索规范数据,精准组装提示词,生成符合国标规范的8宫格证件照组合套图,自动分割导出独立证件照,并交付规格说明与打印指导文档。
{
"workflow_id": "id_photo_generation_specification",
"input": {
"portrait_img": {
"field_name": "portrait_img",
"default": "",
"description": "原始上传肖像人像图(传入标准Base64编码字符串或普通URL)。无图直接终止流程,禁止重绘、替换人脸五官",
"example": "https://oss.showapi.com/doc/4888/3/ccf048c94e17_1782290826572.jpg?x-oss-process=image/resize,p_100",
"type": "base64",
"required": true
},
"bg_color": {
"field_name": "bg_color",
"default": "blue",
"description": "底色枚举(white纯白/blue浅蓝/red大红)",
"example": "blue",
"type": "string",
"required": true
},
"id_size": {
"field_name": "id_size",
"default": "一寸",
"description": "证件照尺寸枚举(小一寸/一寸/大一寸/小二寸/二寸/大二寸)或自定义格式(宽x高,如26x32)",
"example": "一寸",
"type": "string",
"required": true
}
},
"steps": [
{
"id": "step_1_vision_analyze",
"point_code": "",
"result": [],
"api_code": "portrait_vision_analyze",
"backend_type": "prompt_api",
"status": "PENDING",
"name": "肖像五官特征视觉提取",
"action": "run",
"params": {
"img_list": [
{
"url": "{{@input.portrait_img}}"
}
],
"user_prompt": "严格提取图中人物的五官特征(眼型/鼻型/唇型/眉型)、面部轮廓骨相(脸型/下颌线/颧骨)、表情肌肉状态(肌肉放松度/嘴角角度/眼部张力)、原生着装特征。输出必须客观中立,严禁修改或美化描述。"
}
},
{
"id": "step_2_generate_keywords",
"point_code": "",
"result": [],
"api_code": "generate_keywords",
"backend_type": "prompt_api",
"status": "PENDING",
"name": "合规规范检索关键词生成",
"action": "run",
"params": {
"bg_color": "{{@input.bg_color}}",
"id_size": "{{@input.id_size}}"
}
},
{
"id": "step_3_search_compliance",
"point_code": "1",
"result": [],
"api_code": "3289",
"backend_type": "sys_api",
"status": "PENDING",
"name": "合规规范数据检索",
"action": "run",
"params": {
"abstract": "1",
"query": "{{@step_2_generate_keywords.result.data.result}}"
},
"depends_on": [
"step_2_generate_keywords"
]
},
{
"id": "step_4_build_prompt",
"point_code": "",
"result": [],
"api_code": "id_photo_prompt_builder",
"backend_type": "prompt_api",
"status": "PENDING",
"name": "证件照提示词精准组装",
"action": "run",
"params": {
"facial_features": "{{@step_1_vision_analyze.result.data.result}}",
"bg_color": "{{@input.bg_color}}",
"id_size": "{{@input.id_size}}"
},
"depends_on": [
"step_1_vision_analyze"
]
},
{
"id": "step_5_start_image_gen",
"point_code": "1",
"result": [],
"api_code": "3373",
"backend_type": "sys_api",
"status": "PENDING",
"name": "启动8宫格证件照生成",
"action": "run",
"params": {
"referImages": [
"{{@input.portrait_img}}"
],
"prompt": "{{@step_4_build_prompt.result.data.result}}",
"size": "1024x1024"
},
"depends_on": [
"step_4_build_prompt"
]
},
{
"id": "step_6_poll_image_status",
"point_code": "",
"result": [],
"api_code": "polling",
"backend_type": "sys_api",
"status": "PENDING",
"name": "轮询图像生成状态",
"action": "run",
"params": {
"result_url": "{{@step_5_start_image_gen.result.data.result_url}}"
},
"depends_on": [
"step_5_start_image_gen"
],
"polling": {
"interval_seconds": 5,
"timeout_seconds": 600,
"success_condition": "{{@step_6_poll_image_status.result.data.task_status}} === 'SUCCEEDED'"
}
},
{
"id": "step_7_split_image",
"point_code": "1",
"result": [],
"api_code": "3405",
"backend_type": "sys_api",
"status": "PENDING",
"name": "8宫格证件照分割",
"action": "run",
"params": {
"img_url": "{{@step_6_poll_image_status.result.data.result_url}}",
"cols": "4",
"rows": "2"
},
"depends_on": [
"step_6_poll_image_status"
]
},
{
"result": [],
"iterator": "{{@step_3_search_compliance.result.data.result}}",
"status": "PENDING",
"aggregates": [
{
"field": "data.result",
"into": "merged_compliance_contents"
}
],
"params": {
"bg_color": "{{@input.bg_color}}",
"upstream_content": "{{@search_item.content}}",
"id_size": "{{@input.id_size}}"
},
"depends_on": [
"step_3_search_compliance"
],
"point_code": "",
"id": "step_8_search_result_merge",
"backend_type": "prompt_api",
"api_code": "generate_keywords",
"item_name": "search_item",
"name": "合并合规检索原始数据",
"action": "foreach"
},
{
"id": "step_9_spec_doc_gen",
"point_code": "",
"result": [],
"api_code": "spec_doc_generator",
"backend_type": "prompt_api",
"status": "PENDING",
"name": "规格说明与打印指导文档生成",
"action": "run",
"params": {
"split_image_info": "{{@step_7_split_image.result.data.remark}}",
"bg_color": "{{@input.bg_color}}",
"compliance_data": "{{@step_3_search_compliance.result.data.remark}}",
"id_size": "{{@input.id_size}}"
},
"depends_on": [
"step_3_search_compliance",
"step_7_split_image"
]
}
],
"output": {
"spec_doc_content": {
"field_name": "spec_doc_content",
"description": "证件照规格说明与打印指导文档内容",
"value": "{{@step_9_spec_doc_gen.result.data.result}}",
"type": "string"
},
"final_prompt_preview": {
"field_name": "final_prompt_preview",
"description": "组装后的完整生图提示词预览",
"value": "{{@step_4_build_prompt.result.data.result}}",
"type": "string"
},
"split_image_urls": {
"field_name": "split_image_urls",
"description": "分割后的8张独立证件照图像URL列表",
"value": "{{@step_7_split_image.result.data.file_list}}",
"type": "array"
},
"original_grid_image_url": {
"field_name": "original_grid_image_url",
"description": "8宫格证件照合集原图URL",
"value": "{{@step_6_poll_image_status.result.data.result_url}}",
"type": "string"
}
}
} 提交后立即返回 task_id,系统每 2 秒自动轮询一次运行状态并可视化执行步骤,适合耗时较长的 Skill。
portrait_img必填base64原始上传肖像人像图(传入标准Base64编码字符串或普通URL)。无图直接终止流程,禁止重绘、替换人脸五官
bg_color必填string底色枚举(white纯白/blue浅蓝/red大红)
id_size必填string证件照尺寸枚举(小一寸/一寸/大一寸/小二寸/二寸/大二寸)或自定义格式(宽x高,如26x32)
把这个 Skill 接入你的应用或 AI Agent —— 自带 REST API、OpenAPI 规范与 Agent 技能包。
task_id,再轮询查询任务状态与结果。下方按调用顺序列出两个端点。 https://route.showapi.com/flow/execute/6a44b9a73c51f2a84f000bf9?appKey={AppKey}https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}执行中途出错时
status 返回 FAILED, remark 给出错误信息; step_status_list 仅包含已执行到的部分阶段, output 为已产出的部分结果(可能为空或不完整)。
所有 API 响应均使用平台统一封装,业务数据嵌套在 showapi_res_body 中

7*24小时服务
保证您的售后无忧

1v1专属服务
保证服务质量

担保交易
全程担保交易保证资金安全

服务全程监管
全周期保证商品服务质量
© 2015-2023 WWW.SHOWAPI.COM ALL RIGHTS RESERVED.昆明秀派科技有限公司
本网站所列接口及文档全部由SHOWAPI网站提供,并对其拥有最终解释权 POWERED BY SHOWAPI