linkfox-aigc-clothing-suite
根据服装参考图生成模特图、卖点图、种草图、尺码图、白底图、普通及高级 A+ 营销素材,支持品牌风格、排版和场景参考,并跟进生成与素材交付。适用于服装营销套图、服饰电商视觉制作和 apparel image suite;不适用于通用图像创作、独立视频生成或其他无关创意操作。
SKILL.mdskills/linkfox-aigc-clothing-suite/SKILL.md
GitHub服装营销套图
适用范围
适用
用户提供服装参考素材,希望生成一组可交付的服饰营销图片时使用。
场景速查
| 用户表达 | 处理场景 |
|---|---|
| 给这件衣服做一套营销图 | 按用户需要组合模特、卖点、种草、尺码与白底素材。 |
| 为服装制作 A+ 页面素材 | 结合品牌风格与排版要求生成普通、高级及手机版 A+ 素材。 |
| 套图还没完成,继续查结果 | 恢复已接受任务并交付结果。 |
| 图片下载失败了,再保存一次 | 使用已保存的查询结果重试下载。 |
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
| 查询模型枚举 | GET ${LINKFOX_AI_API_URL}/image/model/config/list?bizType=69 |
references/api.md | scripts/wear_collection_async.py --list-models --inline |
获取当前可用模型枚举及能力。 |
| 服装套图创建 | POST /aigc/wearCollection → 下游 path:/image/auth/agent/imagemake/wearCollection |
references/api.md | scripts/wear_collection_async.py |
创建异步服装营销套图任务。 |
| 任务查询 | POST /aigc/taskQuery |
references/api.md | scripts/query_task.py |
查询本次或已存在的图像、视频任务。 |
| Base64 素材上传 | POST /aigc/uploadByBase64 |
references/file-upload.md | scripts/upload_by_base64.py;文件入口 scripts/upload_file.py |
将本地或外部素材转为生成可用的素材地址。 |
模型选择
先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。
前置条件
准备服装参考素材,明确需要的图片类型、数量和品牌风格。构造请求前阅读 references/api.md;上传时阅读 references/file-upload.md。
从可写的任务工作目录运行,先检查输出目录;需将产物保存在当前目录时,本次执行取消 ACPX_WORKSPACES。Windows 使用 PYTHONUTF8=1 或 python -X utf8,保证文件与控制台为 UTF-8。
生成与交付流程
- 根据用户需求选择本接口支持的模型、图片类型与风格,向用户解释时用可理解的模型名称。字段、模型及上传要求以接口文档为准,仅使用本接口列出的模型请求码与默认值。
- 完整生成运行
python <skill-root>/scripts/run_task.py '<JSON 参数>'。业务字段全部放入params;requestId、chatId、messageId、title放在外层,不传顶层memberId。脚本先上传本次所需的每个不同来源,保留图片顺序,并在多个字段间复用本次上传映射;全部上传成功后才创建一次任务。长参数或恢复方式见接口文档。 - 保存已接受任务的编号及创建响应,按接口文档的等待预算与间隔持续查询。超时保留任务,用
python <skill-root>/scripts/run_task.py --task-id <已保存编号>恢复查询,不重新上传或创建。 - 成功后脚本下载结果到会话
media/,保留完整查询 JSON,并在data/保存含素材类别、编号、下载失败和最终费用的清单。失败或超时不得自动更换模型、重建任务或增加数量。下载失败只执行python <skill-root>/scripts/download_results.py <已保存查询JSON>重试下载,继续生成前说明额外消耗。 - 解析输出的
Saved full response: ["<绝对媒体路径>", ...],成功图片用 Markdown展示,视频用本地链接或播放器展示。读取清单说明下载失败与实际费用;不要读取二进制媒体,也不要向用户复述该协议行。 - 明确需要底层操作时可分别使用上传、创建和查询入口;低层创建使用上传后素材地址,查询绕过缓存,成功查询后执行下载脚本完成交付。认证或算力问题按解决认证和算力问题处理。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:生成按实际出图数量、模型、分辨率与品质累计扣点,详见算力消耗预估。同一会话内,相同生成需求只提交一次;已有任务沿用其编号查询。底层创建入口提供 24 小时本地响应缓存,不能据此重复运行完整创建流程。生成失败或超时不得自动更换模型、重建任务或增加数量;下载失败只重试下载,继续生成前说明额外消耗。
输出策略
以下策略适用于底层 API 入口;完整流程 run_task.py 的媒体和清单输出见生成与交付流程。
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-aigc-clothing-suite-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。costCredit需从保存的 JSON 按需提取。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
素材上传免费 (限时);生成按实际出图数量、模型、分辨率与品质累计扣点。完整模型费用表见 references/api.md。创建时的费用占位值不能作为免费依据,以终态查询和实际费用头为准;未返回费用时说明未知。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
requestId 为可选兼容字段;提供时新任务使用唯一值,同一操作沿用原值,原样转发,缺失时不自动生成。超时使用已接受的 taskId 恢复查询,不自动重新创建。
区分接受与完成:异步任务返回编号仅表示接受,不能将创建响应或 JSON 文件作为生成图片交付。超时后沿用原任务;新增生成需求才创建新任务。
素材先行:本地与外部素材均走本技能内置上传流程,不改用 STS、OSS 或其他上传路径;查询时不重复上传。所有素材处理及媒体限制见接口定义。
保留实际费用:展示生成状态、成功媒体、下载失败和实际报告的消耗,不用创建占位费用覆盖最终费用,也不推断服务端未返回的单项错误或尺寸。
保护凭证与素材:不展示密钥、授权头、Base64、内部工具标识或签名源地址,不把登录令牌、验证码或密钥写入任务、缓存或源文件。403 归属或权限错误不按充值问题处理;短信及支付按用户选择执行,不自动轮询支付。
使用友好表达:面向用户用模型名称和素材类别解释结果;模型请求码只在请求中使用。模型实际支持能力以接口文档为准。
保留反馈上下文:反馈参数类型不符、异常响应或持续查询失败时,记录接口路径、请求及任务编号和脱敏错误摘要,不包含凭证、Base64 或私密素材内容。
稳定保存产物:业务入口会在请求前检查当前目录可写,并固定会话输出目录。公共调用器具有目录回退逻辑,流程不得依赖回退;完整流程与底层入口均从指定任务目录运行。
避免重复消耗:底层创建与上传入口提供一层 24 小时响应缓存;完整流程只复用本次上传映射,文件上传辅助入口绕过响应缓存,查询始终获取新状态。各入口缓存与 CLI 约定见接口文档。
使用示例
生成服装模特图与卖点图
用户:用这件衣服的参考图,做一张模特图和一张卖点图,突出透气棉质。
确认图片组合及风格,按接口定义准备完整参数,运行 scripts/run_task.py 完成上传、创建、查询与下载,展示本地图片和实际费用。
完整流程的 JSON 参数示例(将路径替换为本次任务的实际值):
{
"params": {
"imageList": ["<服装参考图本地路径>"],
"sellerPoint": "透气棉质服装",
"modelTypeNum": 1,
"sellerTypeNum": 1
}
}
完整流程会先上传本地素材;单独调用底层创建入口时,imageList 必须改为上传返回的 viewUrl。requestId 为可选兼容字段;提供时原样转发,缺失时不自动生成。检查或恢复同一任务时使用已接受的 taskId,不重新创建。
恢复生成或补下载
用户:继续刚才的套图任务。
沿用已保存任务编号查询;若任务已经成功但文件未保存,读取终态查询 JSON,仅运行 scripts/download_results.py,不再生成。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。