ahang1598 商品详情页
使用时机
用于生成 5～10 张一组的电商详情页。如只要单张精修、商品主图、KOC 拼图或视频，使用对应 Skill。
调用流程
- 收集 1～5 张商品图、商品类目，可选收集最多 5 张参考详情图。
- 参考图为空时必须询问生成风格；确认语言、数量、卖点/参数和可选 AI 模特。
- 仅传 HTTPS 素材 URL，说明将使用当前 OAuth 空间并按服务端计费，调用
create_detail_page_task。 - 保留返回的任务 ID，用
get_user_tasks传入该taskId和taskType=detail_page查询到终态。 - 告知用户实际成功图数；超时、失败或部分成功时不得自动重建任务。
工具与参数
create_detail_page_task
| 参数 | 必填 | 说明 |
|---|---|---|
productImages |
是 | 1～5 张商品图 HTTPS URL |
referenceImages |
条件 | 最多 5 张参考详情图；与 generationStyle 至少提供一项 |
productCategory |
是 | 商品类目 |
generationStyle |
条件 | 参考图为空时提供的风格描述 |
language |
否 | 输出语言，默认简体中文 |
extraDescription |
否 | 卖点、尺寸参数或指定文案等补充要求 |
imageCount |
否 | 5～10，默认 5 |
aiModelId |
否 | 已授权 AI 模特 ID |
aspectRatio |
否 | 默认 3:4；auto 仅 GPT Image 2 支持 |
resolution |
否 | 公开分辨率，服务端按模型能力校验 |
model |
否 | 当前公开图像模型 |
get_user_tasks
| 参数 | 用法 |
|---|---|
taskId |
创建返回的任务 ID |
taskType |
固定为 detail_page |
status |
可选状态筛选 |
limit |
精确查询时取最小值 |
权限、积分与安全边界
- OAuth 获取与刷新：首次连接时由 WorkBuddy 打开浏览器完成 OAuth；access token 到期后由客户端使用 refresh token 自动轮换；授权失效后重新连接。
- OAuth 绑定用户、空间和 operator，不索要 Token；他人任务和素材不可使用。
- 仅传 HTTPS URL，不传本地路径、
data:/base64、localhost、私网、供应商 URL 或签名存储查询串。 - 服务端重验 MIME/magic、尺寸、数量、模型能力、空间权限和积分；客户端显示不是计费事实。
- 商品功效、参数、价格和认证必须来自用户素材；不负责据参考图臆测。
错误处理
使用稳定公开错误码解释要修改的素材、参数、权限或余额；不透传供应商错误、原始提示词、存储地址或内部堆栈。不自动重试会产生新任务或扣费的操作。