下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/showapi--storefront-signboard-design-showapi.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @showapi/storefront-signboard-design-showapi。基于用户上传的门头照片和设计要求,进行安全审核、视觉特征分析和需求意图解析,融合生成专业生图提示词,输出重绘后的门头设计效果图及后续优化建议;适用于店铺装修设计、招牌改造预览、门头效果重绘、电商美工出图场景
阅读全文 (展开查看完整说明)
概述
招牌门头设计
任务目标
- 基于一张门头照片 + 一句设计要求,快速生成重绘后的门头设计效果图
- 具备合规校验、图片安全审核、门头视觉特征分析、设计需求意图解析、专业提示词融合、效果图生成与轮询、设计优化建议等全链路能力
- 触发场景:店铺装修设计、招牌风格改造预览、门头清晰度/质感提升、电商美工批量出图
能力组成
能力流程描述
该技能以「门头照片(img_url)」为主输入,辅以「设计要求(design_request)」与「效果图比例(aspect_ratio)」,完整链路如下:
- 合规校验优化(step_0):对用户输入的原始需求进行合规校验与优化,保证后续流程输入安全、表述规范。
- 图片安全审核(step_1):将门头照片提交安全审核接口,判断图片是否合规(normal 表示正常),审核通过后才继续后续环节。
- 并行分析阶段:
- 门头视觉特征分析(step_2):识别并提取招牌主色调与辅助色、材质(亚克力/铝塑板/霓虹灯/LED发光字等)、文字排版布局与大概内容、整体风格(现代简约/复古/科技感等)、灯光布置情况;
- 设计需求意图解析(step_3):将用户的自然语言设计要求(如“改为小清新风格,文字放大显眼”)解析为结构化的设计指令。
- 融合生成专业提示词(step_4):将视觉特征分析结果与设计指令融合,生成专业级生图提示词,确保重绘既保留原图结构又体现设计意图。
- 生成门头设计效果图(step_5):以融合提示词 + 参考原图 + 指定比例,调用图像生成能力产出效果图。
- 轮询效果图生成状态(step_6):以 5 秒间隔轮询生成任务状态(超时 1200 秒),直至任务状态为 SUCCEEDED,拿到效果图 URL。
- 门头设计优化建议(step_7):结合设计指令与最终生成提示词,输出后续专业修改建议、备选风格方案等拓展信息。
数据流转方式:各步骤结果通过内部变量引用(@step_xxx.result.data.result)逐级传递;异步模式下,任务提交后返回唯一 task_id,外部通过轮询查询接口逐步获取中间进度与最终结果。
技能能力组成流程图
flowchart TD
A["用户输入: 门头照片img_url + 设计要求design_request + 比例aspect_ratio"] --> B["step_0 合规校验优化"]
B --> C["step_1 图片安全审核"]
C -->|审核通过| D["step_2 门头视觉特征分析<br/>主色调/材质/排版/风格/灯光"]
C -->|审核通过| E["step_3 设计需求意图解析"]
D --> F["step_4 融合生成专业提示词"]
E --> F
F --> G["step_5 生成门头设计效果图<br/>prompt+referImages+aspect_ratio"]
G --> H["step_6 轮询生成状态<br/>间隔5s/超时1200s"]
H -->|task_status=SUCCEEDED| I["step_7 门头设计优化建议"]
H -->|未完成| H
I --> J["输出: 效果图URL + 安全审核状态 + 设计优化建议"]前置准备
- 凭证:配置 ShowAPI AppKey,凭证名称:showapi_appkey
- 鉴权配置:
本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。
如何获取 AppKey
如果你还没有 AppKey,请按以下步骤通过手机验证获取:
- 请用户提供手机号(中国大陆手机号)
- 调用发送验证码接口:
“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded
phone={手机号} “ 成功响应:{"flag":true,"remark":"发送成功"}`
- 请用户查看手机收到的6位验证码并告诉你
- 调用验证接口获取 AppKey:
“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded
phone={手机号}&code={验证码} “ 成功响应:{"flag":true,"app_key":"你的AppKey"}`
- 将获取到的 app_key 保存,后续所有 API 调用 URL 中携带
appKey={app_key}参数
注意事项
- 验证码5分钟有效,每分钟只能发送1次
- 如果手机号已注册过易源数据平台账户,会直接返回该账户的 AppKey,不会重复注册
- AppKey 获取后请妥善保存,避免重复验证
- 模拟体验:无 appKey 时,系统自动触发模拟调用,直接返回完整结果,快速预览生成效果
- 依赖:仅使用 Python 标准库,无需安装第三方包
操作步骤
模拟体验流程(无 appKey)
- 自动触发模拟调用
系统检测到未配置 appKey 时,自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求(body: {"flow_id":"6a8675e73c51f20e38006bcf"}),直接获取完整模拟生成结果。此过程为一次性返回,不执行 execute_task.py 和 query_task.py。
- 可视化预览
将返回的 JSON 结果以 HTML 形式可视化展示,重点呈现门头设计效果图图片内容。
- 引导真实调用
提示用户当前为无 appKey 的模拟运行结果。如需真实调用,请通过手机验证获取 AppKey(步骤见「前置准备-鉴权配置」),并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。
标准流程(有 appKey,强制异步执行)
- 收集用户需求
收集门头照片(可上传 URL 或 base64 字符串,base64 建议先压缩)、设计要求(如“保持原图结构不变,提升整体清晰度和质感”)、期望效果图比例(1:1、3:4、4:3、16:9、9:16)。
- 异步提交生成任务
调用脚本异步执行门头效果图生成任务,仅返回唯一 task_id,不阻塞等待。调用示例:
python scripts/execute_task.py --img-url "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_4eea77e4-e059-411f-8897-94575c31c833.jpg" --design-request "改为小清新风格,文字放大显眼" --aspect-ratio 3:4 --async- 轮询查询任务结果(必选)
使用 task_id 循环查询任务状态,每一轮轮询后,即时将当前返回的核心资料同步反馈给用户(如安全审核状态、生成进度、效果图 URL、设计建议等),直至获取完整结果。调用示例:
python scripts/query_task.py --task-id "返回的task_id值"- 等待结果完成
必须轮询直到完成(效果图生成通常需要数十秒至数分钟,请耐心轮询)。
- 结果解析与落地应用
提取 generated_image_url 效果图链接、safety_status 审核状态(normal 为正常),并结合 design_suggestions 中的 improvements(改进建议)、alternative_styles(备选风格)、next_actions(后续行动)迭代优化设计。
- 生成html页面
生成一个简单的html页面来融合返回的主要信息,特别是门头设计效果图与原图的对比展示。
使用示例
示例1:门头提质增强
- 输入:上传门头照片,不填设计要求(使用默认值“保持原图结构不变,提升整体清晰度和质感”)
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:结构不变、清晰度和质感提升的门头效果图 + 设计优化建议
- 配置要点:design_request 留空即可,aspect_ratio 与原图保持一致选 1:1
示例2:门头风格改造预览
- 输入:门头照片 + 设计要求“改为小清新风格,文字放大显眼”
- 流程:异步提交任务 → 获取task_id → 轮询查询(每轮反馈进度/数据)
- 产出:小清新风格的新门头效果图 + 改进建议与备选风格方案
- 配置要点:design_request 描述尽量具体(风格、文字、配色、灯光等)
示例3:多平台适配出图
- 输入:同一张门头照片,批量生成不同比例效果图
- 流程:多次异步提交任务(分别指定 1:1、3:4、9:16 等)→ 分别轮询查询
- 产出:适配店铺招牌打印、电商详情页、短视频封面等多用途效果图
- 配置要点:招牌打印选 4:3/3:4,电商主图选 1:1,短视频封面选 9:16
生成效果示例
描述
技能运行完成后,输出包含三部分核心内容:一是重绘后的门头设计效果图(generated_image_url,可直接在浏览器打开或嵌入页面展示);二是原图的安全审核结果(safety_status,normal 表示正常);三是结构化的设计优化建议(design_suggestions),其中 improvements 为当前设计图的改进建议,alternative_styles 为可拓展的备选风格方案,next_actions 为后续落地行动建议。整体输出结构清晰,图片即所得,建议可直接指导门店装修与招牌制作。
输出案例
说明:若输出结果包含图片,优先插入对应图片资源,之后再输出 JSON / Markdown 格式的文本内容。
效果图示例一:
效果图示例二:
效果图示例三:
接口返回的 JSON 数据实际形态:
{
"showapi_res_body": {
"generated_image_url": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/xxx/generated_signboard_design.jpg",
"safety_status": "normal",
"design_suggestions": {
"improvements": [
"招牌底色与文字对比度可进一步提高,增强远距离可读性",
"可在门头两侧增加灯带补光,夜间识别度更佳"
],
"alternative_styles": [
"复古霓虹灯风格:暖色霓虹管勾勒店名,突出夜间氛围",
"极简黑金风格:哑光黑铝塑板+金色立体发光字,质感高级"
],
"next_actions": [
"确认效果图后可按比例导出高清大图交付招牌制作方",
"如需调整文字内容,可携带新文案再次发起重绘"
]
}
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}资源索引
- [scripts/execute_task.py](scripts/execute_task.py):异步提交门头效果图生成任务(真实调用时使用)
- [scripts/query_task.py](scripts/query_task.py):轮询查询异步任务结果(真实调用时使用)
响应数据结构
1. 异步任务提交响应
{
"showapi_res_body": {
"task_id": "唯一任务ID",
"status": "pending",
"msg": "任务已提交,正在异步处理中"
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}2. 任务查询响应(单轮轮询返回数据,需实时同步给用户)
{
"showapi_res_body": {
"generated_image_url": "生成的门头设计效果图URL",
"safety_status": "原图的安全审核结果,normal表示正常",
"design_suggestions": {
"improvements": ["当前设计图的改进建议列表"],
"alternative_styles": ["备选风格方案列表"],
"next_actions": ["后续落地行动建议列表"]
}
},
"showapi_res_code": 0,
"showapi_fee_num": 1
}3. 任务查询响应字段说明
| 字段 | 类型 | 说明 |
|---|---|---|
| generated_image_url | string(url) | 生成的门头设计效果图URL |
| safety_status | string | 原图的安全审核结果标志,normal表示正常 |
| design_suggestions | object | 针对当前设计图的后续专业修改建议、备选风格方案及落地行动建议 |
注意事项
- img_url 为必填项,门头照片可传 URL 或 base64 字符串(base64 建议先压缩,避免请求体过大)。
- 所有任务强制异步执行,不支持同步模式;效果图生成耗时较长,轮询间隔建议 5 秒以上。
- 轮询查询过程中,每次获取接口返回数据后,立即将主要内容反馈给用户。
- 图片安全审核不通过时流程将终止,请更换合规的门头照片后重试。
- 设计建议、备选风格仅作参考,最终装修方案请结合施工条件与预算确定。
- 模拟运行说明:无 appKey 时系统自动触发模拟调用,一次性返回完整 JSON 结果,不经过 execute_task.py 和 query_task.py,结果仅作效果预览,非真实生成内容。如需真实调用,请通过手机验证获取 AppKey 并配置。