Linkfox Wb Linkfox Aigc

[!IMPORTANT] 本 Skill 必须依赖 MCP “LinkFox”。如未安装该MCP，请明确通知用户： 请先安装 LinkFox 连接器：

• 在 WorkBuddy 左侧找到 “专家·技能·连接器” → “连接器”；
• 搜索关键词 “LinkFox”，并安装连接器 “LinkFox”（注意：是 linkfox，不是 linkfox-product-selection），按指引完成登录授权；
• 返回 WorkBuddy 重试。

LinkFox 商品图像与视频（LinkFox Product Images and Video）

根据商品素材、提示词和用途生成或编辑跨境营销内容，交付文本、图片、视频链接及任务编号。覆盖13个子能力、15个生成与查询 endpoint，另有 AIGC 素材上传与通用文件上传2个辅助 endpoint。

能力边界

• 通用生图：文生图或参考图生图，使用 linkfox-aigc-imagegen 的 /aigc/imageGenAsync，精确 toolName 为 aigc/imageGenAsync。
• 文本与媒体理解：营销文案、改写及图片或视频分析，使用 linkfox-aigc-textgen 的 /aigc/textGenAsync，精确 toolName 为 aigc/textGenAsync。
• 商品营销套图：非服装商品的白底、场景、特写、卖点及 A+ 图，使用 linkfox-aigc-product-suite 的 /aigc/productMarketMaterial，精确 toolName 为 aigc/productMarketMaterial。
• 服装营销套图：服装的模特、种草、尺码、卖点、白底及 A+ 图，使用 linkfox-aigc-clothing-suite 的 /aigc/wearCollection，精确 toolName 为 aigc/wearCollection。
• 智能修图：按要求修改一张原图，使用 linkfox-aigc-image-edit 的 /aigc/imageEdit，精确 toolName 为 aigc/imageEdit。
• 多图融合修图：按素材角色融合多张参考图，使用 linkfox-aigc-multi-image-edit 的 /aigc/multiImageFusion，精确 toolName 为 aigc/multiImageFusion。
• 视频生成：单图或所选模型支持的首尾帧生成，使用 linkfox-aigc-videogen 的 /aigc/videoGenAsync，精确 toolName 为 aigc/videoGenAsync。
• 多场景视频生成：结合多参考图的商品、人物与场景生成视频，使用 linkfox-aigc-videogen-multi 的 /aigc/multiImageVideoGenAsync，精确 toolName 为 aigc/multiImageVideoGenAsync。
• 图转视频：商品图、模板及可选参考视频驱动的视频创作，使用 linkfox-aigc-image-to-video 的 /aigc/imageToVideo，精确 toolName 为 aigc/imageToVideo。
• 带货口播视频：按商品图和口播脚本生成营销视频，使用 linkfox-aigc-sales-video 的 /aigc/salesVideo，精确 toolName 为 aigc/salesVideo。
• 商品视频复刻：参考视频与当前商品图结合生成，使用 linkfox-aigc-video-reclone 的 /aigc/videoReclone，精确 toolName 为 aigc/videoReclone。
• 视频编辑：按指令修改原视频，可选参考图，使用 linkfox-aigc-video-edit 的 /aigc/videoEditing，精确 toolName 为 aigc/videoEditing。
• 视频翻译：翻译原视频语音并可同步口型，使用 linkfox-aigc-video-translate 的 /aigc/videoTranslation，精确 toolName 为 aigc/videoTranslation。

套图由服务端一次创建，品牌要求直接填可选 brandKey，自动卖点提取使用 isExtractPrePoint。不要求先提取品牌基因，不在本地逐张编排套图。尺码、规格和功效等事实必须有用户资料支持，缺少尺码数据先补充资料，不从图片猜测尺寸。

不执行平台发布、店铺操作或知识产权检测。视频内容理解只产出分析文本；用户要求视频产物时选择相应视频接口。生成、复刻、翻译和编辑结果不等于平台审核通过。

工具选择指南

先确定交付物，再确定素材角色、类型和数量。沿用用户已明确的模型、语言、比例与数量，只补充影响结果或费用的缺失信息。不因为套图含多个图片类型而额外创建多次通用生图，也不为普通单图任务先做一次收费文本分析。

业务需求路由速查

本地辅助 scripts/local/download_results.py 下载成功任务返回的图片或视频 URL，不创建或查询任务、不访问业务网关。参数表和模型限制按需读取对应 reference；套图、修图及专用视频的外层契约见 material-common.md，视频查询、模型与交付规则见 video-common.md。

MCP 调用方式

所有业务请求使用 LinkFox.proxy_call，toolName 为原 endpoint 去掉前导 / 的精确值，保留大小写。原请求对象直接放入 arguments，不得额外包 body / data 或第二层 arguments。

**区分两类请求结构：**通用生图、生文、videoGenAsync、multiImageVideoGenAsync 及查询参数直接位于 arguments，例如 arguments.prompt 或 arguments.taskId。商品套图、服装套图、两种修图，以及图转视频、口播、复刻、编辑、翻译原生具有外层结构，必须保留 arguments.requestId 和 arguments.params，业务参数放进 params，创建时不传顶层 memberId。不能把这些接口的业务字段提升到顶层，也不能给直接传参的接口增加 params。视频的 videoType 枚举、声音、尾帧、参考图数量和时长规则按所选入口读取，不能互换。

WorkBuddy 自动注入 Authorization，不索取、不展示、不配置凭证，请求不加入 headers、API Key、token、JWT 或手机号。MCP 不可用时读取 onboarding.md，不得回退 HTTP 或旧网关脚本。

素材准备

• 套图、两种修图与五个专用视频接口：先读取 aigc-upload.md，本地文件与外部 URL 都通过 aigc/uploadByBase64 转为 viewUrl。仅复用已知上传成功的 viewUrl，不凭域名判断上传状态。保持图片或视频数组顺序，独立的原视频、参考视频、尾帧、模特图、场景图字段也要处理；上传失败不创建任务。视频翻译只需要原视频，视频编辑参考图可选。
• 通用生图、媒体理解与前两项通用视频生成可使用公开可访问的 URL。需要把本地文件或产物公开时，读取并按本 skill 内置的 references/file-upload.md 执行。通用 OSS URL 不替代上述九类专用接口要求的 viewUrl。
• 仅上传本次任务需要的素材，保存来源与成功 URL 的映射；查询不重新上传。

创建、查询和失败处理

1. 创建前确定类型、数量、模型、分辨率、比例及文案语言；视频还需确定时长、声音与素材模式，翻译选择目标语言及口型同步，说明费用未知项。用户已授权的具体生成请求直接执行；新增图片、视频变体、参考视频、手机版 A+ 或额外收费分析必须符合用户要求。
2. 每个请求只创建一次。九类使用原生外层的接口使用唯一 requestId，保存返回的 taskId 和查询接口。不能把 requestId 当作重复创建一定不扣费的保证。
3. 先检查连接、schema 和 isError，再读取 structured content 或解析一次 text JSON，检查下游 error、errcode、errorCode、code、success 和消息字段。空体、无 taskId 或无法识别的响应不能当作创建成功。
4. 创建后可查询一次。PROCESSING 时返回原编号，图片或文本建议至少等待10秒，视频建议约2分钟；用户后续明确继续时再查询一次，不自动循环。后续获准的状态查询可使用相同 taskId，不得重复创建。
5. SUCCESS 时使用实际 resultList[].url 或文本 content；成功但结果为空时报告异常。FAILED 展示脱敏 errorMsg，不自动重试、换模型或改素材。网络中断导致是否创建未知时说明不确定性，不重新提交。
6. 需要本地图片或视频时，将成功查询的业务对象保存为 UTF-8 JSON，执行 python <skill-root>/scripts/local/download_results.py <response.json> --out-dir <directory>。下载失败保留 URL，只补下载，不重新生成。

MCP 不承诺旧脚本的缓存、自动落盘或 stdout 摘要。追溯记录只包含任务编号、请求摘要与脱敏业务响应，不包含凭证或素材 Base64。

使用示例

执行前替换占位素材与请求编号，不得用示例地址发起收费测试。内部模型值仅用于调用，面向用户使用可读模型名称。套图、修图和五项专用视频的素材 URL 均代表上传成功后的 viewUrl。

通用生图：无参考图时 imageUrls 可为空。示例生成1张正方形图片，模型显示名为“LF全能模型 Pro”。

{"toolName":"aigc/imageGenAsync","arguments":{"imageUrls":[],"prompt":"A minimalist studio photograph of a ceramic cup on a neutral background","provider":"LF_BN_3","outputNum":1,"resolution":"1K","aspectRatio":"1:1"}}

文本生成：纯文本传 imageUrls: []；分析媒体时替换为真实 URL，模型及思考等级见对应 reference。

{"toolName":"aigc/textGenAsync","arguments":{"prompt":"将已确认卖点改写为三条英文短文案，不增加新事实：便携、可拆洗。","imageUrls":[],"model":"GEM_3_FLASH","thinkingLevel":"minimal"}}

商品营销套图：一次创建1张卖点图和1张场景图，其余类型默认0。未开启自动提取必须提供真实卖点。

{"toolName":"aigc/productMarketMaterial","arguments":{"requestId":"<unique-product-request>","params":{"imageList":["https://example.com/uploaded-product-viewUrl.png"],"sellerPoint":"便携，可拆洗","provider":"GPT_2_5_IMAGE","resolution":"2K","aspectRatio":"1:1","quality":"medium","sellerTypeNum":1,"sceneTypeNum":1,"brandKey":{"language":"英语","platform":"亚马逊"}}}}

服装营销套图：一次创建1张模特图和1张白底图。模特、场景描述写入 modelAndSceneInfo；尺码图需要用户提供真实尺码。

{"toolName":"aigc/wearCollection","arguments":{"requestId":"<unique-clothing-request>","params":{"imageList":["https://example.com/uploaded-clothing-viewUrl.jpg"],"sellerPoint":"用户已确认的面料与版型描述","provider":"GPT_2_5_IMAGE","resolution":"2K","aspectRatio":"3:4","modelTypeNum":1,"whiteTypeNum":1,"modelAndSceneInfo":"成年模特，简洁摄影棚背景"}}}

智能修图：使用单数 imageUrl，每任务输出1～4张；模板可能覆盖模型及提示词优化选项。

{"toolName":"aigc/imageEdit","arguments":{"requestId":"<unique-edit-request>","params":{"imageUrl":"https://example.com/uploaded-source-viewUrl.png","prompt":"将背景改为纯白，保留商品形状、颜色和标识","provider":"GPT_2_5_IMAGE","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium","needOptimize":false}}}

多图融合修图：使用 imageList，明确素材角色；参考图上限依所选模型检查。

{"toolName":"aigc/multiImageFusion","arguments":{"requestId":"<unique-fusion-request>","params":{"imageList":["https://example.com/uploaded-product-viewUrl.png","https://example.com/uploaded-scene-viewUrl.png"],"prompt":"保留第一张的商品外观，将商品自然放入第二张场景，匹配光影和透视","provider":"GPT_2_5_IMAGE","outputNum":1,"resolution":"2K","aspectRatio":"1:1","quality":"medium"}}}

视频生成与多场景视频生成：前者用 imageUrl，后者用 imageList，均直接传参数。下例为5秒 Seedance 2.0 视频；若用尾帧，必须重新核对所选入口和模型是否支持。

{"toolName":"aigc/videoGenAsync","arguments":{"imageUrl":"https://example.com/public-first-frame.jpg","videoType":"SEED","videoTime":5,"prompt":"缓慢推进镜头展示商品细节","resolution":"720p","aspectRatio":"9:16"}}

{"toolName":"aigc/multiImageVideoGenAsync","arguments":{"imageList":["https://example.com/public-product.jpg","https://example.com/public-scene.jpg"],"videoType":"SEED","videoTime":5,"prompt":"结合商品与场景参考，生成连贯展示镜头","resolution":"720p","aspectRatio":"9:16"}}

图转视频：商品展示模板与手写 prompt 二选一，素材使用上传后的 viewUrl。参考视频另有素材互斥与费用倍率，执行前读对应 reference。

{"toolName":"aigc/imageToVideo","arguments":{"requestId":"<unique-image-video-request>","params":{"imageList":["https://example.com/uploaded-product-viewUrl.jpg"],"videoType":"doubao-seedance-2-5","videoTime":10,"templateKey":"product-showcase","productInfo":"用户已确认的商品外观和细节信息","language":"英文","saleCountry":"美国","resolution":"720p","aspectRatio":"9:16"}}}

带货口播视频：商品图和口播脚本必填，语言、语气及卖点要求写进 prompt，不增加未定义的声音或人物ID字段。

{"toolName":"aigc/salesVideo","arguments":{"requestId":"<unique-sales-video-request>","params":{"imageList":["https://example.com/uploaded-product-viewUrl.jpg"],"videoType":"doubao-seedance-2-0","videoTime":10,"prompt":"用自然英文口播介绍用户已确认的商品卖点，结尾邀请了解详情","resolution":"720p","aspectRatio":"9:16"}}}

商品视频复刻：参考视频与商品图都上传；分辨率、市场和目标语言必填。下面不传 prompt，由服务端分析；已有最终脚本时传 prompt 将跳过分析。

{"toolName":"aigc/videoReclone","arguments":{"requestId":"<unique-reclone-request>","params":{"refVideoUrl":"https://example.com/uploaded-reference-viewUrl.mp4","refImageList":["https://example.com/uploaded-product-viewUrl.jpg"],"videoType":"doubao-seedance-2-0","resolution":"720p","saleCountry":"US","targetLanguage":"en","videoTime":10}}}

视频编辑：原视频必填，参考图片可选。下例模型仅跟随原视频时长，videoTime=-1，不传固定秒数。

{"toolName":"aigc/videoEditing","arguments":{"requestId":"<unique-video-edit-request>","params":{"sourceVideoUrl":"https://example.com/uploaded-source-viewUrl.mp4","prompt":"将背景替换为摄影棚，保留商品外观和主体动作","videoType":"kling-v3-omni","videoTime":-1}}}

视频翻译：目标语言与原视频必填，口型同步默认开启，所有模型跟随原视频时长，不传 videoTime。

{"toolName":"aigc/videoTranslation","arguments":{"requestId":"<unique-video-translation-request>","params":{"sourceVideoUrl":"https://example.com/uploaded-source-viewUrl.mp4","targetLanguage":"en","lipSync":true}}}

图像及视频任务返回 taskId 后使用 aigc/taskQuery，文本任务使用 aigc/textTaskQuery，不能混用：

{"toolName":"aigc/taskQuery","arguments":{"taskId":"<image-taskId>"}}

{"toolName":"aigc/textTaskQuery","arguments":{"taskId":"<text-taskId>"}}

展示规则

1. 先交付可用产物：文本直接给内容，图片给预览，视频给可播放或可点击 URL；本地交付附真实路径。创建成功不表示媒体已生成。
2. 多张结果按实际 type 分类，不识别的标为未分类。分别列出计划数量和返回数量，不按返回顺序猜类型或承诺全部成功。
3. 未完成时展示任务编号和状态，失败给错误摘要与可行的下一步。不展示原始 MCP 包装、Base64 或认证信息。
4. 模型用可读名称。通用生图的 LF_* 别名与套图、修图的 GPT_* 等枚举不可直接互换，按对应 reference 填写。
5. 仅展示实际返回的计费字段及原单位；创建响应 costToken=0 不表示免费，费用缺失记为未知，不把历史扣点称为实时价格。
6. 商品事实来自用户资料。标注 AI 生成或模型分析性质，不声称平台审核、认证或侵权检测通过；单项错误、宽高、格式等未返回字段不能推断为已核实。
7. 视频模型名称和参数按各入口解释；实际音轨、口型或人物效果以结果为准，不把合成人物口播展示为真实用户背书。视频翻译应核对商品名、数字与单位，不声称已获人工审核。

解决认证和积分问题

遇到连接器缺失、认证、权限或积分异常时读取 references/onboarding.md。WorkBuddy 自动注入 Authorization，不索取、不展示、不配置凭证。

用户明确要求反馈时，可使用独立反馈接口 https://skill-api.linkfox.com/api/v1/public/feedback，字段为 skillName、sentiment、category、content。skillName 使用本 skill 名称，sentiment 取 POSITIVE / NEUTRAL / NEGATIVE，category 取 BUG / COMPLAINT / SUGGESTION / OTHER；只发送脱敏问题摘要。

积分消耗说明

用户会因积分消耗而支付费用。请充分评估：当需要高频调用本技能，或用户对积分消耗量预期不足时，务必提醒用户，由用户决定是否继续。