Queenshow 商品详情页生成

要解决什么问题

电商与运营团队经常要为 editor-next 产出结构化商品详情页：主图、长文案、分区配图和可编辑文档。手工对接上传、等 AI 出大纲、再逐段等图，既慢又容易在 主图 URL 复用、轮询时机和保存方式上踩坑。

技能如何工作

本技能围绕 Queenshow 官方 OpenAPI（/openapi/*）描述完整流水线，并配套 scripts/detail_page_client.py 做可重复调用：

• 鉴权：每个请求使用 Authorization: Bearer 或 X-API-Key
• 素材：POST /openapi/materials/upload 上传本地图/视频，或引用已有公开 URL
• 创建页：POST /openapi/detail-pages 提交商品信息（product.mainImages 必填，最多 3 个 URL），同时触发 product_outline_generate
• 大纲：轮询 GET /openapi/detail-pages/{id}/status 至 outline_ready，再 POST .../outline/apply 生成分区占位并提交 section_image_generate
• 收尾：状态 completed 后 GET /openapi/detail-pages/{id} 校验文档节点；用 POST .../update 写回标题、缩略图、商品字段或整份 document

技能文档还整理了 9 个行业 的风格与配色参考，以及批量跑数时的轮询间隔、单页约 110–130 幻币 的成本量级。

边界与注意点

• OpenAPI 没有 publish 接口，持久化依赖 update；分享链路与是否「发布」无关
• 禁止跨商品复用 mainImage URL，否则易出现内容串页
• 须 先上传再创建；批量任务 遇错继续下一单，事后集中处理失败任务（GET /openapi/tasks/{taskId}）
• RunningHub 单图超时约 10% 概率；幻币不足可能导致页面被删，大批量前请查 GET /openapi/usage
• 前端/代理与直连后端的 Base URL 不同：https://your-host/api/promotion 与 http://localhost:8890/promotion