蛋糕草图效果图生成-万维易源

概述

蛋糕草图效果图生成

任务目标

• 面点师/烘焙从业者上传蛋糕草图，快速生成对应的蛋糕实际效果图，实现「手绘草图 → 可交付效果图」的转化
• 具备合规校验、草图视觉深度分析、设计意图推断、生图提示词智能构建、图像生成、结果轮询能力
• 触发场景：蛋糕设计方案可视化、草图效果预览、与客户确认蛋糕样式、烘焙作品展示与宣传

能力组成

能力流程描述

本技能以「蛋糕草图图片URL + 用户提示词 + 宽高比（可选）」为输入，串联五个核心阶段产出最终效果图：

1. 合规校验优化：对用户输入的提示词进行合规校验与优化，保障输入内容安全可用；
2. 蛋糕草图视觉深度分析：解析草图图片，输出设计意图摘要、草图质量等级与结构化实体分析，为提示词构建提供依据；
3. 蛋糕效果图生图提示词智能构建：融合草图分析结果与用户原始提示词，构建完整生图提示词，并根据用户意图动态调整还原约束策略——若提示词包含"丰富效果"或"美化"意图，系统将适度放松还原约束（moderate_restore / enriched）；否则默认严格忠实还原草图；
4. 启动蛋糕效果图生成任务：以草图图片为参考图，按指定宽高比启动图像生成任务；
5. 轮询蛋糕效果图生成状态：以5秒间隔轮询任务状态（最长1200秒），直至任务成功并返回最终效果图URL。

各阶段数据通过步骤结果引用自动流转，全程无需人工干预，最终输出：蛋糕效果图URL、约束策略、草图质量等级、最终提示词、设计意图摘要五项结构化结果。

技能能力组成流程图

flowchart TD
    A["用户输入：蛋糕草图图片URL + 提示词 + 宽高比"] --> B["合规校验优化"]
    B --> C["蛋糕草图视觉深度分析"]
    C --> D["草图分析结果：<br/>设计意图摘要 / 质量等级 / 结构化实体"]
    D --> E["蛋糕效果图生图提示词智能构建"]
    E --> F{"用户意图判定"}
    F -->|"提示词含'丰富效果'或'美化'意图"| G["约束策略：moderate_restore / enriched<br/>适度放松还原约束"]
    F -->|"默认"| H["约束策略：strict_restore<br/>严格忠实还原草图"]
    G --> I["启动蛋糕效果图生成任务<br/>参考图：草图 + 指定宽高比"]
    H --> I
    I --> J["轮询生成状态<br/>间隔5秒 / 超时1200秒"]
    J -->|"任务进行中"| J
    J -->|"SUCCEEDED"| K["输出：蛋糕效果图URL / 约束策略 / 草图质量等级 / 最终提示词 / 设计意图摘要"]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
• 鉴权配置：

本 Skill 调用需要 AppKey 鉴权。所有 API 请求的 URL 查询参数中需携带 appKey={你的AppKey}。

如何获取 AppKey

如果你还没有 AppKey，请按以下步骤通过手机验证获取：

1. 请用户提供手机号（中国大陆手机号）
2. 调用发送验证码接口：

“` POST https://www.showapi.com/auth/agent_sendCode Content-Type: application/x-www-form-urlencoded

phone={手机号} “ 成功响应：{"flag":true,"remark":"发送成功"}`

1. 请用户查看手机收到的6位验证码并告诉你
2. 调用验证接口获取 AppKey：

“` POST https://www.showapi.com/auth/agent_verify Content-Type: application/x-www-form-urlencoded

phone={手机号}&code={验证码} “ 成功响应：{"flag":true,"app_key":"你的AppKey"}`

1. 将获取到的 app_key 保存，后续所有 API 调用 URL 中携带 appKey={app_key} 参数

注意事项

• 验证码5分钟有效，每分钟只能发送1次
• 如果手机号已注册过易源数据平台账户，会直接返回该账户的 AppKey，不会重复注册
• AppKey 获取后请妥善保存，避免重复验证
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

系统检测到未配置 appKey 时，自动向 https://www.showapi.com/_nuxt3/api/2405-105 发送 POST 请求（body: {"flow_id":"6a5dd4263c51f27b2a04695a"}），直接获取完整模拟生成结果。此过程为一次性返回，不执行 execute_task.py 和 query_task.py。

1. 可视化预览

将返回的 JSON 结果以 HTML 形式可视化展示，重点呈现图片内容。

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请通过手机验证获取 AppKey（步骤见「前置准备-鉴权配置」），并在后续所有 API 调用 URL 中携带 appKey={app_key} 参数。

标准流程（有 appKey，强制异步执行）

1. 收集用户需求

需要用户提供：可公网访问的蛋糕草图图片URL（必填）、对蛋糕效果的描述提示词（必填）、生成图像宽高比（选填，默认1:1，可选 1:1、3:4、4:3、16:9、9:16）。提示词意图说明：若包含"丰富效果"或"美化"意图，系统将适度放松还原约束；否则默认严格忠实还原草图。

1. 异步提交生成任务

调用脚本异步执行草图分析、提示词构建与效果图生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --prompt "丰富细节，使得蛋糕显得更加精美" --img "http://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/img_bd33a790-352e-4b3b-87cc-274c01c58a9e.jpg" --aspect-ratio 1:1 --async

1. 轮询查询任务结果（必选）

使用 task_id 循环查询任务状态，每一轮轮询后，即时将当前返回的核心资料同步反馈给用户，直至获取完整结果。调用示例：

   python scripts/query_task.py --task-id "返回的task_id值"

1. 等待结果完成

必须轮询直到完成。图像生成需要一定时间（工作流内置轮询最长1200秒、间隔5秒），请耐心轮询，不要中途停止。

1. 结果解析与落地应用

提取蛋糕效果图URL、约束策略、草图质量等级、最终提示词与设计意图摘要，理解本次生成所采用的还原策略，用于后续方案调整或直接交付。

1. 生成html页面

生成一个简单的html页面来融合返回的主要信息，特别是图片。

使用示例

示例1：忠实还原草图

• 输入：上传手绘蛋糕草图，提示词"严格按照草图还原蛋糕结构与装饰"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：与草图高度一致的蛋糕效果图，constraint_strategy=strict_restore
• 配置要点：提示词不包含美化类词汇，宽高比默认1:1

示例2：丰富效果模式

• 输入：上传草图，提示词"丰富细节，使得蛋糕显得更加精美"
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：在保留草图设计特征基础上适度丰富细节的精美效果图，constraint_strategy=enriched
• 配置要点：提示词需包含"丰富效果"或"美化"类意图

示例3：竖版效果图用于手机端展示

• 输入：上传蛋糕草图，指定宽高比9:16
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：适配手机端展示的竖版蛋糕效果图
• 配置要点：aspect_ratio=9:16，也可选 1:1、3:4、4:3、16:9

生成效果示例

描述

技能运行完成后，输出以结构化JSON为主：核心字段 result_image_url 为最终生成的蛋糕效果图访问地址，可直接在浏览器或HTML页面中查看；constraint_strategy 标识本次采用的约束策略（strict_restore 严禁过度美化 / moderate_restore 适度还原 / enriched 允许丰富效果），反映提示词构建如何响应用户意图；sketch_quality_level 为草图质量等级（high 细节清晰 / medium 轮廓清晰 / low 模糊粗糙）；final_prompt 为实际使用的完整生图提示词；design_intent_summary 为设计意图摘要。可视化展示时优先呈现效果图图片，便于直观评估草图还原度与整体质感。

输出案例

说明：若输出结果包含图片，优先插入对应图片资源，之后再输出 JSON / Markdown 格式的文本内容。

接口返回JSON示例（任务完成后的完整结果）：

{
  "showapi_res_body": {
    "design_intent_summary": "草图描绘一款单层圆形奶油蛋糕，顶部点缀草莓与奶油裱花，整体风格清新简约，适合生日等庆祝场景",
    "result_image_url": "https://showapi-pub-hangzhou.oss-cn-hangzhou.aliyuncs.com/huangye/cake_result_sample.jpg",
    "sketch_quality_level": "medium",
    "constraint_strategy": "enriched",
    "final_prompt": "专业蛋糕摄影：单层圆形奶油蛋糕，严格保留草图中蛋糕的分层结构与顶部草莓、裱花装饰，细节丰富、质感精美，奶油细腻有光泽，柔和自然光，浅色背景"
  },
  "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": {
    "design_intent_summary": "基于草图与用户prompt推断的设计意图摘要",
    "result_image_url": "最终生成的蛋糕效果图URL",
    "sketch_quality_level": "草图质量等级：high/medium/low",
    "constraint_strategy": "约束策略：strict_restore/moderate_restore/enriched",
    "final_prompt": "构建的最终生图提示词完整内容"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. img（蛋糕草图图片URL）与 prompt（效果描述提示词）为必填项；草图URL需可公网访问，否则分析阶段将失败。
2. aspect_ratio 为选填项，默认1:1，可选值：1:1、3:4、4:3、16:9、9:16。
3. 所有任务强制异步执行，不支持同步模式；轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
4. 图像生成需要一定时间（工作流内置轮询最长1200秒、间隔5秒），请耐心轮询直至任务完成，不要中途停止。
5. 若提示词包含"丰富效果"或"美化"意图，系统将适度放松还原约束；否则默认严格忠实还原草图，请根据实际需要编写提示词。
6. sketch_quality_level、constraint_strategy、final_prompt 等字段可用于理解生成依据，辅助后续调整提示词与草图。
7. 每次成功调用按次计费（预估约0.26元/次，含模型推理价格），请合理安排调用频次。
8. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请通过手机验证获取 AppKey 并配置。