linkfox-aigc-video-reclone
结合参考视频与商品图复刻商品视频,支持销售国家、目标语言和自定义提示词,并完成素材准备、生成状态跟踪与结果交付。适用于商品视频复刻、品牌二创和商品短视频制作;不适用于通用图像生成、视频翻译、视频编辑或其他无关创作。
SKILL.mdskills/linkfox-aigc-video-reclone/SKILL.md
GitHub商品视频复刻
适用范围
适用
用户提供参考视频与商品图片,希望制作面向指定市场和语言的新商品视频时使用,包括 product video recreation。
场景速查
| 用户表达 | 处理场景 |
|---|---|
| 参考这个视频,为我的商品复刻一条 | 准备素材、创建复刻任务并交付视频。 |
| 按我的分镜或提示词复刻 | 使用用户提供的最终提示词生成。 |
| 继续查看之前的视频任务 | 使用已接受任务编号续查。 |
| 生成成功,但视频下载失败 | 根据已保存查询响应重试下载。 |
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
| 查询模型枚举 | GET ${LINKFOX_AI_API_URL}/image/video/model/config/list?bizType=89 |
references/api.md | scripts/video_reclone_async.py --list-models --inline |
获取当前可用模型枚举及能力。 |
| 商品视频复刻 | POST /aigc/videoReclone;实际下游 /image/auth/agent/imagemake/videoReclone |
references/api.md |
scripts/video_reclone_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 |
上传本地文件或已下载的外部素材。 |
模型选择
先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。
前置条件
准备本次参考视频、商品图及创作目标;构造参数前读取 接口定义 和 素材上传。从可写的任务工作目录运行脚本,先确认输出目录可写;如设置了指向其他目录的 ACPX_WORKSPACES,本次运行应取消该变量。Windows 使用 PYTHONUTF8=1 或 python -X utf8。
执行流程
- 阅读接口定义,按本次目标选择文档支持的模型和创作方案。对用户使用模型的友好名称;请求中保留模型代码,仅使用本接口支持的模型代码和默认值。
- 完整生成使用
python <skill-root>/scripts/run_task.py '<JSON 参数>';长参数用--params-file <路径>或-从标准输入读取。脚本将本地路径和外部 URL 全部经本目录 Base64 上传后再创建任务,同一源只上传一次,多图顺序保持不变;只复用本次流程自己的源地址映射。上传失败即停止。 - 创建一次并保留已接受的任务编号及响应文件,按 查询等待策略 轮询任务。超时保留任务,用
python <skill-root>/scripts/run_task.py --task-id <已保存编号>续查,不重新上传或创建。 - 成功后将媒体保存到会话 media 目录,保留终态查询 JSON 与 data 目录中的资产清单。下载失败使用
python <skill-root>/scripts/download_results.py <已保存查询JSON>,只重试下载。 - 解析
Saved full response: ["<绝对媒体路径>", ...]中的文件,结合资产清单交付媒体、任务状态、下载失败项与实际费用。 - 显式低层操作可使用接口清单中的创建、查询和上传脚本。低层成功查询后仍需运行下载脚本交付媒体。认证及余额问题按执行规则中的指引处理。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:生成按模型、分辨率对应的每秒单价 × 视频时长计费。同一会话、同一参数组合默认只创建一次;创建和直接上传入口提供 24 小时本地缓存,查询及素材辅助上传不使用缓存。生成失败或超时不得自动更换模型、重建任务或扩大生成数量;下载失败只重试下载,继续生成前说明额外消耗。
输出策略
- 始终保存完整响应,目标路径为
<cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-aigc-video-reclone-<接口标识>-<timestamp>.json。<cwd>为脚本运行时的工作目录,<session>优先取环境变量SESSION_ID,用于聚合同一任务的数据。禁止写入/tmp,当前目录不可写时应报错。 - 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
- 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如
total、costToken)、最大列表字段的长度和前 3 条样本。 - 添加
--inline可强制全量打印到标准输出,同时仍保存文件。
先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。
执行规则
算力消耗预估
复刻费用取决于模型、分辨率和时长,按 接口定义中的扣费参考 估算;上传免费 (限时),创建响应中的零费用不代表最终免费,最终使用查询及费用头报告的实际值,缺失表示未知。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
requestId 为可选兼容字段;提供时原样转发,缺失时不自动生成。超时使用已接受的 taskId 恢复查询,不自动重新创建。
接受与完成分开说明:任务编号只表示接受,终态及结果以查询为准。该查询兼容已有图像和视频任务,不切换到不存在的 makeTaskQuery。
避免重复消耗:提供 requestId 时,新任务使用唯一值,同一任务检查或重试沿用该值。生成失败或超时不自动换模型、重建任务或扩大生成数量;继续生成前说明额外消耗。下载失败只重试下载。
展示媒体:图片使用合法 Markdown
;视频使用本地文件链接或播放器。不要读取二进制媒体、将 JSON 当作视频,或向用户复述原始协议行。如实展示结果:展示本地媒体、任务状态、下载失败及实际费用。没有单项生成状态或错误时不推断;不以创建时的零费用覆盖查询费用。
保护素材和凭证:不展示模型内部请求代码、签名源 URL、API Key、Authorization、Base64 或内部工具标识。凭证不写入任务 JSON、缓存或源代码。普通技能不伪装其他调用渠道。
反馈脱敏:反馈保留请求路径、请求编号或任务编号及脱敏错误摘要,不附凭证、Base64 或私密素材内容。
认证与充值:保留用户选择的自助或手机号登录流程;选择手机号路径后才发送短信,用户选择套餐和支付方式后才创建订单,不自动轮询付款。403 归属或权限错误不能通过充值解决。
使用示例
复刻商品视频
用户:参照这个视频,为商品图中的产品制作面向美国市场的英文视频。
确认素材和创作目标,选择文档支持的方案,使用完整流程准备素材、提交一次并等待结果,交付本地视频与实际费用。
继续等待与恢复下载
用户:刚才超时的任务继续查一下,成功后把视频给我。
使用已保存编号续查;成功后下载媒体。若已有成功查询响应而仅下载失败,直接运行下载恢复入口。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。