文创设计师 AI Skill 教程
一、技能简介
文创设计师是一款面向文创产品视觉设计场景的 AI Skill，支持基于用户输入的提示词与可选参考图，按指定宫格数（1/2/3/4）与宽高比（1:1、3:4、4:3、16:9、9:16）自动生成符合落地产出规范的文创设计图。Skill 内置意图解析与参数校验、提示词机械构建、生图任务提交、任务状态轮询四步标准流程，确保提示词构建过程完全透明可控，不做任何语义扩写或美化。适用于文创周边产品宣传图、IP 形象衍生物料、节庆礼盒视觉稿、博物馆/景区纪念品图等需要多宫格组合呈现的视觉物料场景，覆盖文创设计的前期出图需求。
二、核心特性
- 透明可控的提示词构建：采用机械拼接方式构建生图提示词，遵循严格的 A/B 分支融合逻辑，绝不进行语义扩写或美化，结果可追溯、可复现，便于用户复用与微调。
- 宫格与比例自由组合：支持 1/2/3/4 四种宫格数量与 5 种常见宽高比，覆盖横版海报、方版主图、竖版封面等主流物料尺寸，适配多场景。
- 可选参考图接入：支持 URL 与 Base64 双格式参考图，无需图片时自动走 A 分支纯文本生图路径，灵活兼容有无参考素材的不同工作流。
- 异步任务 + 实时轮询：采用异步执行机制，单次提交即返回 task_id，结合轮询可清晰查看每一步的执行状态与结果数据，便于集成到自动化产线。
- 结构化输出与可校验参数：返回结果包含 validated_grid_num、validated_aspect_ratio、final_prompt 等字段，用户可核对实际生效参数，避免非法值导致的歧义。
- 配套 OpenAPI/Agent 技能包：提供 REST API、OpenAPI 规范与 Agent 技能包三种集成方式，可直接嵌入企业应用、智能体或自动化脚本。
三、主要用途
- 文创周边产品宣传图：为帆布袋、马克杯、保温杯、笔记本、徽章、钥匙扣等周边产品生成统一风格的视觉稿，支撑电商详情页与线下展陈物料。
- IP 形象衍生设计稿：在已有 IP 形象基础上，扩展节庆礼盒、盲盒、手办等系列化衍生物料的视觉方案。
- 景区/博物馆纪念品图：为景区、城市文旅项目、博物馆文创衍生品设计纪念品视觉稿，体现地域文化特色。
- 节庆礼盒视觉方案：春节、中秋、端午等节庆礼盒的封面视觉、礼盒拆解图、组合陈列图一站式生成。
- 品牌联名物料图：为品牌跨界联名、文创跨界合作项目产出多风格预览图，辅助决策沟通。
四、功能特点
| 参数 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
grid_num |
int | 必填 | 画面排版宫格数量，仅支持 1、2、3、4，非法值将被兜底为 4 |
image |
string | 选填 | 参考图 URL 或 Base64 编码字符串，传入参考图后系统自动走 B 分支融合路径 |
prompt |
string | 选填 | 文创设计主题提示词，可为空；为空时由系统按宫格数与比例自动补全内容 |
aspect_ratio |
string | 选填 | 图像宽高比，可选值：1:1、3:4、4:3、16:9、9:16，非法值将被兜底为 1:1 |
输出参数说明：
validated_grid_num：实际生效的宫格数量validated_aspect_ratio：实际生效的宽高比final_prompt：最终送入生图节点的提示词（机械拼接结果）result_url：生成图片的公网访问 URLhas_image：是否使用了参考图
五、操作流程
第 1 步：进入技能页
打开 文创设计师 AI Skill 页面，查看介绍、参数说明与样例。
第 2 步：浏览能力组成
在「能力组成」区域查看技能 5 步内部流程：理解需求 → 搭建提示词 → 开始创作 → 耐心等待 → 作品完成。
第 3 步：查看输出案例
在「输出案例」区查看官方样例，了解不同主题、不同宫格的实际生成效果。
第 4 步：进入在线运行
点击「立即试一试」进入在线运行模块。
第 5 步：填写参数并执行
按参数对照表填入宫格数、宽高比、提示词与参考图（可选），点击「运行」发起异步任务，页面会按步骤展示执行轨迹并在任务结束后展示最终生成图。
接入提示：除网页在线运行外，技能还支持 REST API、OpenAPI 规范与 Agent 技能包三种接入方式。REST 调用采用
POST https://route.showapi.com/flow/execute/{skill_id}?appKey={AppKey}异步接口，提交后立即返回task_id，再以GET https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}轮询获取结果。
六、实际案例
以下 3 张样例图均为官方输出案例，展示技能在「彩云之南」系列文创周边场景下的实际落地效果。
案例 1：3 宫格横版 IP 形象周边组合
案例 2：4 宫格方版 IP 形象与产品矩阵
案例 3：4 宫格产品组合陈列图
七、在线运行实录
7.1 创意场景设计
本次实操模拟「江南水乡文创丝巾礼盒」场景，输入参数如下：
| 参数 | 填写值 |
|---|---|
grid_num |
2 |
prompt |
江南水乡文创丝巾礼盒，水墨笔触，淡雅色调，乌篷船、流水、青砖黛瓦元素 |
aspect_ratio |
16:9 |
image |
（空，走 A 分支纯文本生图路径） |
7.2 异步提交与轮询全过程
① 提交执行
请求方式：POST https://route.showapi.com/flow/execute/6a4c58393c51f2d32d00c4fc?appKey={AppKey}
立即返回：
{
"showapi_res_code": 0,
"showapi_res_body": {
"flow_id": "6a4c58393c51f2d32d00c4fc",
"flow_name": "文创设计师",
"task_id": "3519_6a68113f3c51f2492b005214",
"ret_code": 0,
"remark": "success"
}
}
② 任务状态轮询
请求方式：GET https://route.showapi.com/flow/task/query/{task_id}?appKey={AppKey}
| 阶段 | 状态 | 进度 |
|---|---|---|
| +3s | RUNNING | - |
| +11s | RUNNING | 75%（步骤 1-3 已完成） |
| +26s | SUCCESS | 100% |
③ 步骤执行轨迹（完整 4 步）
| 顺序 | step_id | step_name | 状态 |
|---|---|---|---|
| 1 | step_1_intent_analyzer | 意图解析与参数校验 | SUCCESS |
| 2 | step_2_prompt_mechanical_builder | 提示词机械构建 | SUCCESS |
| 3 | step_3_submit_image_task | 提交生图任务 | SUCCESS |
| 4 | step_4_poll_image_status | 轮询生图任务状态 | SUCCESS |
总耗时：54.7 秒
④ 最终返回结果关键字段
{
"status": "SUCCESS",
"used_time": 54.7,
"output": {
"validated_grid_num": 2,
"validated_aspect_ratio": "16:9",
"result_url": "https://promptimg.showapi.com/tasks/dded4e21938742a4a02abe10dac67cd8.png",
"has_image": false,
"final_prompt": "江南水乡的文创周边：水乡水墨丹青色，飞檐翘角古建筑。青石板路苔藓砖，民国元。要求做成一套2宫格图片，每个宫格风格不一样，宫格之间不要有白线"
}
}
7.3 最终成图展示
7.4 结果解读
- 参数兜底与校验生效：本次输入
grid_num=2、aspect_ratio="16:9"均在合法范围内，validated_grid_num=2、validated_aspect_ratio="16:9"与输入一致，无需兜底。 - 提示词机械拼接：原 prompt 经 step_2 拼接后补充了「要求做成一套 2 宫格图片，每个宫格风格不一样，宫格之间不要有白线」等约束条件，避免多宫格出现样式雷同与分隔白线。
- 生图任务成功：step_3 提交生图后，step_4 经过 7 次轮询（30.2 秒）拿到 SUCCEEDED 状态，
result_url可直接访问并下载成图。 - 任务 ID 可追溯：
task_id=3519_6a68113f3c51f2492b005214可长期用于结果回查与失败排查。
八、内容小结
本文介绍了「文创设计师」AI Skill 的使用方式，涵盖技能定位、参数说明、操作流程、官方样例与在线运行实录。使用时建议在 prompt 中显式声明宫格数、宽高比、风格、元素、色彩等关键要素，以获得更精准的成图效果。技能提供网页在线运行、REST API、OpenAPI 规范与 Agent 技能包四种使用方式，可按需选择。
