爆款图复制
使用时机
用于读取参考图的构图、布光和表达方式,为目标商品生成结构同类的新图。这不是逐像素复制、商标仿冒、人物身份保留,也不是爆款视频复制。
调用流程
- 选择一种输入:一张参考图配 1~20 张商品图,或 1~20 组逐组配对。两种形式不同时传入。
- 为每张商品图收集可选主体描述,并确认模型、比例、分辨率和质量。
- 仅传 HTTPS 素材 URL,说明当前 OAuth 空间和计费边界,调用
create_visual_migration_task。 - 使用创建返回的
taskId与taskType=visual_migration调用get_user_tasks。 - 只返回当前任务的固化结果;超时、失败或部分成功时不得自动重建任务。
工具与参数
create_visual_migration_task
| 参数 | 必填 | 说明 |
|---|---|---|
referenceImage |
方式 A | 共用视觉参考图 HTTPS URL |
productImages |
方式 A | 1~20 张商品图 HTTPS URL |
subjectDescriptions |
否 | 与 productImages 同顺序,每项最多 40 字符 |
pairs |
方式 B | 1~20 组 {referenceImage, productImage, subjectDescription?} |
aspectRatio |
否 | 输出比例;auto 仅 GPT Image 2 支持 |
resolution |
否 | 公开分辨率,服务端按模型重验 |
quality |
否 | low / medium / high |
model |
否 | 当前公开图像模型 |
方式 A 和方式 B 二选一。不要把展示名称、本地文件或未授权资源 ID 放入 URL 字段。
get_user_tasks
| 参数 | 用法 |
|---|---|
taskId |
创建返回的任务 ID |
taskType |
固定为 visual_migration |
status |
可选状态筛选 |
limit |
精确查询时取最小值 |
权限、积分与安全边界
- OAuth 获取与刷新:首次连接时由 WorkBuddy 打开浏览器完成 OAuth;access token 到期后由客户端使用 refresh token 自动轮换;授权失效后重新连接。
- OAuth 绑定用户、空间和 operator,不索要 Token;创建、查询和结果访问均由服务端鉴权。
- 仅传 HTTPS URL,禁止本地路径、base64、localhost、私网/保留地址或供应商临时 URL。
- 不得使用无授权参考素材,不得复制原品牌标识、人物身份或未经商品图证实的产品事实。
- 数量、素材、权限和积分最终以服务端校验和业务表为准。
错误处理
对外仅解释稳定公开错误码和可操作建议,不透传供应商错误、原始分析、提示词、存储 key 或内部 URL。输入配对、权限、余额或内容安全错误需先修正,不自动重试创建。