服饰图生成

适用范围

适用

用户上传服饰或模特参考图，希望制作单张图片或一套电商图片时使用。

场景速查

用户表达	制作场景
做一张服饰白底图	白底隐形模特：保留衣服版型与细节。
做一张模特图或种草图	标准电商上身展示或 Ins 风格场景。
做卖点图、A+图、尺码图	按类型生成文案版式或两阶段尺码图。
做一套图、出多张不同类型图片	规划、确认、批量执行并汇总交付。

边界

非服饰实物商品转交 linkfox-aigc-imagegen-product；纯图片编辑转交 linkfox-aigc-imagegen；纯文字及视频分别使用 linkfox-aigc-textgen、linkfox-aigc-videogen。已有模特图换姿势/动作裂变不在本范围，该能力由上游构造 posePrompt，不读本技能字典。

接口清单

接口	端点	对应脚本	说明
获取上传凭证	POST /oss/getStsVoucherByAPI	scripts/upload_files.py	为本地素材取得 STS 凭证，再按服务端配置上传至 OSS。

生图、生文、模型列表和品牌基因由下游技能负责；本技能不另定义这些 LinkFox 接口。账号引导使用公共 onboarding 资源。

前置条件

准备服饰参考图，确认单张或套图意图及用户指定的类型和范围。本地素材先按 文件上传 确认可公开后上传；出图流水线只接收图片 URL，不自动上传。缺图时先从上下文补齐，仍无有效图片则停止并请求重新上传。

按需先读取下游 linkfox-aigc-imagegen、linkfox-aigc-textgen 的 SKILL.md，取得官方脚本的绝对路径；品牌基因提取和落盘遵循 linkfox-aigc-imagegen-brand-gene-extract。只通过文档化链路调用下游，不自行实现其 HTTP 请求。

服饰出图流程

1. 先路由：单张特定类型读取 编排参数与类型路由 中对应的 types/ 文档，再按 单张执行细则 执行。多张、多类型和套图进入 运行时索引，随后渐进读取 01-plan.md、02-confirm.md、03-deliver.md；套图运行时禁止读取 maintainer/collection/ 或 types/*.md，禁止 agent 手工做 S1 推理。
2. 单张流水线：校验并保留所有图片顺序 → 用辅助脚本读取模板、填占位符或构建 textgen 参数 → 按下游文档生成图片。白底图静态直出；模特图占位符直出；种草、卖点、A+ 先由 textgen 改写；尺码图先分析再构造出图提示词。必须使用 build_imagegen_prompt.py / build_textgen_params.py，不手拼大 prompt、不直接写 Python 调下游 API。
3. 套图流水线：判定 S0 场景，写 job → run_collection_pipeline.py --phase plan 落盘规划及状态 → 原样转发规划表并等待用户确认（场景 E 为非首次仅追加白底图，跳过确认）→ 仅一次 --phase dispatch → 紧接一次 --phase summary。用户修改后按确认文档使用本地重新展示模式，保留修改并同步任务元数据。agent 顺序执行三个阶段，dispatch 内部用 ThreadPoolExecutor 并发运行 run_one_task.py，agent 禁止拆成多个并发命令重复出图。
4. 确认与复用：以确认后的 image-plan 为唯一执行依据；任务计划数量与确认条目数一致，description 告知模型名。复用已落盘的品牌基因；用户修改品牌基因时重新提取并沿用已明确的生成范围。默认数量、A～G 场景、多商品整体规划和历史卖点去重规则见运行时文档，不能把后续编辑/派生操作放进本轮 imagePlanList。
5. 落盘与交付：所有跨步骤文件落会话 data/media，脚本均用绝对路径。单张从下游 stdout 解析图片路径并按类型追加内联图；套图原样转发 summary 明细，保留每张图的 ![]() 行。status JSON 和 Saved full response: 协议行仅内部解析，不贴给用户。交付后控制权交还调用方，按交付协议处理条件推荐、已有 skuId 的后置流程和建议标签。

执行方式

• 直接调用接口：接口端点、完整参数、响应和错误码见 references/api.md。
• 脚本调用（推荐）：python scripts/upload_files.py '<JSON 参数>' [--inline]。
• 成本约束：本技能按所选参数动态消耗算力。同一会话、同一参数组合默认只执行一次；失败时按单张、套图或上传各自的有界重试规则处理，需额外生成时先说明额外消耗。上传封装始终禁用凭证响应缓存，仅在当前批次复用有效凭证；编排不额外缓存下游结果，生图、生文缓存按下游技能处理，详见 references/api.md。

输出策略

• 上传凭证完整响应保存到 <会话根目录>/<YYYY-MM-DD>/<session>/data/linkfox-aigc-imagegen-cloth-upload-voucher-<timestamp>.json，仅供内部处理，不作为附件交付，也不展示 STS 凭证。会话根目录按 ACPX_WORKSPACES 第一个路径下的 linkfox/ → <cwd>/linkfox/ → 用户目录下的 linkfox/ → 系统临时目录下的 linkfox/ 选择可写路径；<session> 优先取环境变量 SESSION_ID。
• 上传封装捕获公共调用器的凭证输出，stdout 始终打印完整上传结果数组，以及成功项的 Saved full response: 和 Uploaded 日志；--inline 不改变此行为。完整字段见 references/api.md。
• 部分上传失败时保留成功项并以非零状态退出，不重复上传成功项。
• 生图、生文响应与文件落盘遵循下游技能；单张和套图的对话展示按 references/runtime/03-deliver.md 执行。协议行及 status JSON 仅内部解析，不复制进对话。

执行规则

算力消耗预估

算力动态计费，与所选参数相关，不设统一固定单次值。生图、生文和品牌基因提取按对应下游技能的模型配置及实际扣除计算；套图按规划中的任务数量及实际所需阶段估算。上传凭证接口的返回未包含单次算力定额，不单独承诺免费或固定扣费。

声明：算力消耗以实际扣除为准；如因需要调整算力消耗标准，恕不另行通知。最终解释权归 LinkFox 官方所有。

用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时，提醒用户，并由用户决定是否继续。

解决认证和算力问题

出现以下情况时，按 references/onboarding.md 的指引处理：

• 未配置接口密钥：LINKFOX_AGENT_API_KEY 和 LINKFOXAGENT_API_KEY 均为空。
• 响应状态码为 401 或 402。
• 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。

约束与建议

• 动态模型：介绍、推荐或确认前查询图片动态完整列表，展示 name、请求使用 requestValue；只按实际任务能力筛选，不设专用模型白名单、不注入 allowed-models、不自动换模型。未指定时先用 LF智能模型 G-2.5 Sunburst、1K、low 出预览，确认画面后询问是否重出 2K、medium。用户明确指定的参数原样透传，默认策略见 编排参数。
• 多图概念：全部参考图作为一套整体规划，每个任务传入全部 URL。用户要求为每件服饰独立套图时，说明整体规划机制，建议分次上传并让用户选择；不得自行拆分或忽略其拆分意图。各出图任务相互独立，单项失败不影响其他任务。
• 清晰展示：规划表固定六列「序号、类型、简述、卖点、画面内容、比例」，清理单元格竖线和换行、空值用破折号，关键内容不截断；先展示表再确认。内部 S1 推理不逐项汇报。套图全部失败不追加 A+ 推荐或跨 agent 卡片，建议标签按交付文档走兜底。
• 计划管理：单张直出不使用计划工具；套图确认后创建与条目数量一致的任务计划，description 明确模型名。规划和状态以落盘文件为准，不凭上下文记忆重写整份规划。
• 失败护栏：下游业务失败也可能 exit 0，必须解析 stdout 区分图片路径数组和失败 JSON 路径。生图失败不换技能；单张网络、超时或连接失败最多自动重试一次，套图内部已重试则 agent 不再重试，认证、配额、内容拒绝和参数错误按 单张失败处理 与认证引导处理，不把失败响应当成功。
• 上传和 Listing 交付：禁止上传私密或敏感内容，先确认可公开；不修改源文件、不重复上传成功项、不输出 STS。流水线不自动上传；图片若合并进 Listing HTML，调用方保留已有资产清单并在 merge 前将本地 media 路径换成公开 OSS URL。cloth summary 不自动生成 product 的资产清单，不得把本地路径当成 HTML 可用图片地址。
• 模板与能力局限：白底图依赖视角/版型识别，模特图的解码与构图由出图模型一次完成；种草图依赖受众/年龄/性别识别。卖点/A+ 共用模板，版式意图填错会串型。尺码图分析质量影响后续尺码逻辑，用户未提供测量值时生成的数值仅供参考；不得覆盖用户给定数据。敏感词规避是模型自审，无词库确定性兜底；不做改写的白底、模特、种草支线由上游或人工把关。多张参考图仍可能误判主体角色。

使用示例

单张服饰白底图

用户：把这件外套做成一张隐形模特白底图。

确认参考图和当前模型选择，读取白底类型细则，用构参脚本提取静态正文，再调用下游生图并展示内联图。

制作服饰套图

用户：给这件连衣裙做一套图。

按运行时场景规则生成规划表，等待确认后顺序执行 dispatch 和 summary，原样展示成功图与失败项。

制作尺码图

用户：按我给的尺码数据做一张尺码表。

遵循两阶段链路及尺码类型文档，保留用户数据，使用前置分析文件构建出图参数后交付。

使用反馈

当技能有BUG，或技能描述有错误/疏漏/歧义/表述模糊，或技能结果与用户预期不符，或用户表达不满/赞扬，或发现其他可改进之处时，按 references/api.md#Feedback 的指引反馈，不要打断用户当前流程。

---

更多优质、专业的跨境电商技能，请访问 LinkFox Skill。