技能介绍

要解决的问题

拿到一张原片，直接套通用修图工具往往翻车：磨皮过度、构图被裁掉、主体特征丢失。原因在于通用模型不知道这张图里「有什么」——脸型、姿态、光线、背景关系——只能无差别套滤镜。这个技能把「看懂照片」和「重绘优化」串成一条流水线，先做视觉理解，再基于理解结果组装生图提示词，交给高清生图引擎输出接近专业后期水准的成片。

工作原理

技能按五步工作流运行：

合规校验：先对输入图片和需求做合规检测，不通过则直接终止。
视觉分析：识别显著主体（人物、动物、物品），提取脸型、发型、情绪、姿态、朝向等特征；没有显著主体时转而分析整体场景与背景，并排除干扰项。
提示词融合：把视觉分析结果与内置固定优化模板智能组装，生成针对性的专业提示词。
图像生成：将融合后的提示词、原始照片（作参考图）和用户指定的 aspect_ratio（默认 1:1）提交给高清生图引擎，任务强制异步执行，提交后只返回 task_id。
结果轮询：按 5 秒间隔轮询，超时 1200 秒，每轮拿到数据立即同步给用户，完成后返回最终图片 URL 和系统组装的提示词。

实现上依赖 scripts/execute_task.py（提交任务）和 scripts/query_task.py（轮询结果）两个脚本，仅使用 Python 标准库，无需安装第三方包。

适用边界与注意点

它是生成式重绘而非像素级修图：输出是重新绘制的图片，适合美化、画质提升、背景优化，不适合需要 100% 保留原片细节的场景。
真实调用需配置 ShowAPI appKey（凭证名 showapi_appkey）。未配置时系统自动走模拟模式，一次性返回完整 JSON，结果仅供预览，不代表真实生成质量。
任务不支持同步模式，调用方必须实现轮询逻辑，并在每轮回调中即时反馈进度。
photo_image 为必填，支持 Base64 编码或可访问的 URL。