从产品描述创作效果图-万维易源

概述

产品解析图生成

任务目标

• 根据用户产品需求描述与图纸类型，自动生成符合国标工业制图与商业产品渲染规范的8K高清图纸。
• 具备意图解析、模板映射、尺寸像素计算、专业Prompt工程化、异步生图及状态轮询能力。
• 触发场景：工业产品设计、结构分解展示、尺寸标注图制作、商业写实渲染图生成。

能力组成

能力流程描述

该技能从用户输入的产品需求描述出发，经历以下核心阶段流转：

1. 意图与结构化解析：分析用户原始描述（材质、工艺、结构、配色等），提取产品特征并匹配硬性构图模板。
2. 尺寸像素计算：根据用户设定的宽高比例（如1:1、3:4等），自动计算出实际生图所需的高分辨率像素尺寸。
3. 专业Prompt工程化：基于解析的产品特征与模板，生成包含全局约束的英文正向与反向提示词。
4. 异步生图与轮询：提交商用级图纸生成任务，系统自动按照5秒间隔轮询任务状态，超时上限600秒，直至获取最终图纸URL。

技能能力组成流程图

graph TD
    A[用户输入: 需求描述+图纸类型+宽高比] --> B(工业设计意图与规则结构化解析)
    A --> C(工业设计尺寸像素计算)
    B --> D[工业设计专业Prompt工程化]
    C --> D
    D --> E[提交商用级工业图纸生成任务]
    E --> F{轮询工业图纸生成状态}
    F -->|未完成/处理中| F
    F -->|生成成功| G[输出8K高清图纸URL及Prompt数据]

前置准备

• 凭证：配置 ShowAPI AppKey，凭证名称：showapi_appkey
  • 获取方式：访问 https://www.showapi.com 注册账号，登录后进入 https://www.showapi.com/console#/myApp 获取 appKey
• 模拟体验：无 appKey 时，系统自动触发模拟调用，直接返回完整结果，快速预览生成效果
• 依赖：仅使用 Python 标准库，无需安装第三方包

操作步骤

模拟体验流程（无 appKey）

1. 自动触发模拟调用

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

1. 可视化预览

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

1. 引导真实调用

提示用户当前为无 appKey 的模拟运行结果。如需真实调用，请前往 ShowAPI 注册账号（注册即送2元余额），并在 https://www.showapi.com/console#/myApp 获取 appKey。

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

1. 收集用户需求

梳理产品名称、使用场景、材质工艺、内外结构、表面肌理、配色、功能、尺寸特点等设计描述，确认图纸类型(主体图/蓝图/分解图等)及宽高比。

1. 异步提交生成任务

调用脚本异步执行图纸生成任务，仅返回唯一 task_id，不阻塞等待。调用示例：

   python scripts/execute_task.py --prompt "折叠通勤自行车，碳纤维轻量化材质，未来科技流线造型，防水耐磨哑光磨砂表面" --style "蓝图" --aspect-ratio "3:4" --async

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

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

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

4.等待结果完成必须轮询直到完成。

1. 结果解析与落地应用

提取生成图纸的URL、实际生图尺寸及正反向提示词，结合结构化参数进行后续设计优化。

1. 生成html页面

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

使用示例

示例1：产品蓝图生成

• 输入：折叠通勤自行车，碳纤维轻量化材质，未来科技流线造型
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：8K高清蓝图URL + 尺寸像素 + 英文正反向提示词
• 配置要点：style="蓝图"，aspect_ratio="3:4"

示例2：写实渲染图制作

• 输入：智能手表，钛合金表壳，蓝宝石玻璃镜面，牛皮表带
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：逼真的商业渲染效果图
• 配置要点：style="写实渲染图"，aspect_ratio="1:1"

示例3：分解图结构展示

• 输入：机械键盘，铝合金底座，热插拔轴体，RGB背光
• 流程：异步提交任务 → 获取task_id → 轮询查询（每轮反馈进度/数据）
• 产出：清晰的产品结构分解图
• 配置要点：style="分解图"，aspect_ratio="16:9"

生成效果示例

描述

技能最终输出为8K高清商用工业图纸或效果图。返回数据包含图片访问URL、实际生图像素尺寸、生图任务ID以及匹配的工业级正反向英文Prompt。用户可以直接使用URL获取高清图纸，并结合Prompt进一步微调设计。

输出案例

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

{
  "showapi_res_body": {
    "task_id": "a1b2c3d4-e5f6-7890",
    "result_url": "https://oss.showapi.com/generated_image/industrial_design_8k.png",
    "image_size": "3000x4000",
    "matched_template_id": "tpl_blueprint_001",
    "positive_prompt": "industrial design, blueprint, folding bicycle, carbon fiber, matte finish, future tech, streamline, 8k, high resolution",
    "negative_prompt": "lowres, bad anatomy, text, watermark, deformed, blurry"
  },
  "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": {
    "task_id": "生图任务的唯一标识ID",
    "result_url": "最终生成的8K高清商用工业图纸/效果图URL",
    "image_size": "实际生图使用的尺寸像素(宽x高)",
    "matched_template_id": "意图解析映射的硬性构图模板ID",
    "positive_prompt": "工程化生成的英文正向提示词",
    "negative_prompt": "工程化生成的英文反向提示词"
  },
  "showapi_res_code": 0,
  "showapi_fee_num": 1
}

注意事项

1. prompt 为必填项，需清晰描述产品的使用场景、材质工艺、结构、肌理、配色等。
2. style 为必填项，决定了图纸输出的类型，必须为指定枚举值之一。
3. 所有任务强制异步执行，不支持同步模式。
4. 轮询查询过程中，每次获取接口返回数据后，立即将主要内容反馈给用户。
5. 模拟运行说明：无 appKey 时系统自动触发模拟调用，一次性返回完整 JSON 结果，不经过 execute_task.py 和 query_task.py，结果仅作效果预览，非真实生成内容。如需真实调用，请注册 ShowAPI 账号并配置 appKey。