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。

执行流程

  1. 阅读接口定义,按本次目标选择文档支持的模型和创作方案。对用户使用模型的友好名称;请求中保留模型代码,仅使用本接口支持的模型代码和默认值。
  2. 完整生成使用 python <skill-root>/scripts/run_task.py '<JSON 参数>';长参数用 --params-file <路径> 或 - 从标准输入读取。脚本将本地路径和外部 URL 全部经本目录 Base64 上传后再创建任务,同一源只上传一次,多图顺序保持不变;只复用本次流程自己的源地址映射。上传失败即停止。
  3. 创建一次并保留已接受的任务编号及响应文件,按 查询等待策略 轮询任务。超时保留任务,用 python <skill-root>/scripts/run_task.py --task-id <已保存编号> 续查,不重新上传或创建。
  4. 成功后将媒体保存到会话 media 目录,保留终态查询 JSON 与 data 目录中的资产清单。下载失败使用 python <skill-root>/scripts/download_results.py <已保存查询JSON>,只重试下载。
  5. 解析 Saved full response: ["<绝对媒体路径>", ...] 中的文件,结合资产清单交付媒体、任务状态、下载失败项与实际费用。
  6. 显式低层操作可使用接口清单中的创建、查询和上传脚本。低层成功查询后仍需运行下载脚本交付媒体。认证及余额问题按执行规则中的指引处理。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 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。