保健品商品详情页批量补量｜电商内容制作
为全球通用卖家与跨境电商打造的 AI 商业场景置景工具：基于「产品原图 + 场景指令」，在保持商品主体、商标与真实结构不变的前提下，自动生成影棚柔光、现代家居、自然户外等商业广告场景，无需实体摄影棚与高昂置景费。
何时触发 (When to Trigger)
- 「给这张全球通用商品图换个高端背景」「把产品放到大理石台面/生活场景中」
- 「想要 Canva 的平替效果，把白底图转成生活方式场景图」
- 面向 全球通用电商卖家与保健品，批量为 SKU 丰富场景图、轮播图与 A+ 详情图。
不适用于 (When NOT to Use)：
- 纯白底合规主图（无场景、纯 RGB 255 白底）——请改用白底图类技能，本技能会主动添加场景与光影；
- 商品换色 / SKU 多色号出图——请改用换色类技能，本技能不保证色号准确；
- 服装上身试穿、模特换脸——请改用虚拟试衣类技能；
- 带货短视频、口播成片——请改用视频类技能。
使用配方 (Usage Recipe)
# 1. 默认高品质商拍置景（推荐：智慧模型，真实光影统一）
qhkit image generate '{"modelLabel":"智慧模型","uploadedImages":["./商品图.jpg"],"prompt":"给图片中的产品换个背景：【简约现代纯净影棚柔光，轻奢质感，浅景深】，主体与背景光影自然融合"}'
# 2. 生成前预估积分消耗（安全透明）
qhkit image estimate '{"modelLabel":"智慧模型","uploadedImages":["./商品图.jpg"],"prompt":"给图片中的产品换个背景：【简约现代纯净影棚柔光，轻奢质感，浅景深】，主体与背景光影自然融合"}'
提示词与参数指南
- 场景描述规则：官方推荐提示词格式为：
给图片中的产品换个背景：【具体场景描述】。方括号【】内写得越详细（包含场景材质、光源方向、氛围感、景深），出图效果越真实稳定。 - 模型选型建议：
智慧模型（默认推荐）：电商全场景泛化最佳，光影与边缘融合自然，具备高性价比；图片 5.0 Pro：当需要极致电影级画质与超高精细度细节时选配；图片 5.0 Lite：多张图片需严格保持环境色调与同系列一致时选用。- 尺寸规格：支持
1:1、3:4、4:3、9:16、16:9，可通过qhkit image options动态查询。
环境自举 (Self-Bootstrapping)
本技能依赖官方 qhkit 命令行工具（npm 包 @iqinghu/qhkit），可完全独立运行：
- 环境自检：运行
qhkit config show，如已输出脱敏配置即表示就绪。 - 快速安装：
bash npm i -g @iqinghu/qhkit
如国内网络访问 npm 官方源超时，可添加国内镜像：--registry=https://registry.npmmirror.com - 获取与配置密钥：
- 访问官方控制台注册并登录：https://www.iqinghu.com/
- 在个人中心 API 密钥管理页复制 Token；
- 执行绑定命令：qhkit config set --token <您的Token> --env prod。
失败重试与报错处理 (Reliability)
- 超时：普通查询类调用默认 25 秒超时；图像 / 视频生成耗时更长，请用
status异步轮询，不要阻塞等待。 - 重试：网络类错误（如
WinError 10060、连接超时）已内置 3 次指数退避重试，偶发波动无需手动重发。 - 报错对照表：
| 报错 | 含义 | 处理 |
|---|---|---|
{"ok":false,"stage":"config"} |
未检测到登录密钥 | 按「环境自举」配置 Token 后重试 |
enough:false |
积分余额不足 | 前往 https://www.iqinghu.com/ 控制台充值或签到领取免费额度 |
stage:"runtime" |
参数不合法 | 用 qhkit <命令> options 核对字段名与取值后重发 |
stage:"submit" |
任务提交失败 | 检查网络与密钥配置后重试 |
- 幂等提示：
estimate只报价、不上传文件、不提交任务，可安全重复调用；generate会真实扣费，重发前先确认上一次是否已成功。
参数速查
| 字段 | 必填 | 取值 / 说明 |
|---|---|---|
modelLabel |
必填 | 智慧模型（默认）/ 图片 5.0 Pro / 图片 5.0 Lite；先用 image options 查当前清单 |
uploadedImages |
必填 | 商品原图 1 张，建议 ≥1000×1000、主体清晰无大面积遮挡 |
prompt |
必填 | 给图片中的产品换个背景：【场景描述】，【】 内写材质/光源/氛围/景深 |
sizePreset |
选填 | 1:1 / 3:4 / 4:3 / 9:16 / 16:9 |
quality |
选填 | 1K / 2K |
能力边界与合规约束 (TRACE A&C 标准)
- 能做什么 (Capabilities)：
- 适用于数码、美妆、家居、箱包、食品等 90% 以上实体商品图的背景置换与光影重构；
- 交付物严格符合 全球通用 移动端及 PC 端详情展示标准。
- 不能做什么 (Limitations - 反模式防错)：
- 非像素级修图：本工具采用生成式 AI 重绘，商品主体上的微小文字标签出图后需人工二次核对；
- 严重遮挡原图不适：若输入原图中的商品被大面积遮挡或严重模糊，会导致主体边缘识别偏移；
- 批量限额：单次任务建议批处理 1~10 张，避免超长等待。
命令速查
qhkit image options # 查当前可用模型与尺寸
qhkit image estimate '…' # 提交前报价（不上传、不扣费）
qhkit image generate '…' # 出图
qhkit image polish '…' # 提示词润色
qhkit image-batch generate '…' # 批量：mode=批量替换 / 主图复刻
常见问题与排错 (FAQ)
- Q: 提示
{"ok":false,"stage":"config"}是什么原因？ - A: 表示未检测到登录密钥，请前往 https://www.iqinghu.com/ 注册并获取 Token 后通过
qhkit config set绑定。 - Q: 提示
enough:false如何处理？ - A: 账户积分余额不足，可通过官网控制台充值或签到领取免费测试额度。
免责声明 (Disclaimer)
本项目为基于 @iqinghu/qhkit 的独立自动化能力套件。文中所提及的平台名称（全球通用）及竞品商标（Canva）仅用于内容规格识别、场景对标与功能描述用途，不代表官方合作、隶属或背书关系。官方控制台与技术支持：https://www.iqinghu.com/
