linkfox-aigc-image-to-video

通过单图或多图生成视频,支持参考视频、商品展示模板、尾帧和声音等模型能力,并查询任务、下载成品。适用于图转视频、商品展示视频和 image to video;不适用于通用图像生成、视频编辑、视频翻译或其他创作操作。

SKILL.md

GitHub

商品图转视频

适用范围

适用

将用户提供的商品图片或多张参考图片制作成视频,按需求结合参考视频、商品模板、首尾帧或声音能力。

场景速查

用户表达 使用场景
把这张商品图做成视频 单图生成,交付本地视频文件。
用这几张图片展示商品 多图参考,保持素材顺序与主体一致。
参考这段视频的动作和节奏 结合图片及参考视频制作商品视频。
做一个产品展示、种草或痛点解决视频 根据商品资料使用相应模板。
上次任务还没完成,继续查询 续查已接受任务,完成后下载成品。

接口清单

接口 端点 接口文档 对应脚本 说明
查询模型枚举 GET ${LINKFOX_AI_API_URL}/image/video/model/config/list?bizType=30 references/api.md scripts/image_to_video_async.py --list-models --inline 获取当前可用模型枚举及能力。
图转视频(imageToVideo) POST /aigc/imageToVideo → 下游 path:/image/auth/agent/imagemake/imageToVideoV3 references/api.md scripts/image_to_video_async.py 创建一个异步任务。
查询任务(taskQuery) POST /aigc/taskQuery references/api.md scripts/query_task.py 查询新建及既有图像/视频任务。
Base64 上传(uploadByBase64) POST /aigc/uploadByBase64 references/file-upload.md scripts/upload_by_base64.py;scripts/upload_file.py 在生成前统一上传本地及外部素材。

模型选择

先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。

前置条件

准备用户希望生成的视频效果及相关素材;读取 接口定义 与 素材上传说明,选择接口实际支持的能力。 从可写的任务工作目录运行脚本;Windows 使用 python -X utf8。输出位置、环境与 CLI 约定见接口定义。

执行流程

  1. 阅读接口定义,按用户需求选择当前模型与模板;面向用户使用友好模型名称,构造请求时使用文档明确支持的模型代码与默认值。
  2. 业务字段必须嵌套在非空 params 对象中。完整任务运行 python <skill-root>/scripts/run_task.py '<JSON 参数>'。它先上传每个不同来源的素材,复用本次映射并保留列表顺序;全部上传成功后只创建一次任务。较长输入、文件和标准输入的用法见接口定义。
  3. 保存已接受的任务编号,等待并轮询任务状态。超时保留原任务,用 python <skill-root>/scripts/run_task.py --task-id <已保存编号> 继续查询,不重新上传或创建。查询失败按实际错误处理,生成失败不自动换模型、重建任务或增加生成数量。
  4. 成功后下载结果媒体,保存终态查询响应及资产清单,记录实际费用与下载失败项。下载失败只运行 python <skill-root>/scripts/download_results.py <已保存的成功查询JSON> 重试下载,不重新生成。
  5. 从 stdout 的 Saved full response: [本地路径数组] 取得成品路径;读取资产清单核对费用和下载情况,再交付文件。低层创建/查询入口保留,低层成功查询后同样执行下载脚本。

执行方式

  • 直接调用接口:接口端点、完整参数、响应和错误码见 references/api.md。
  • 脚本调用(推荐):python <脚本路径> '<JSON 参数>' [--inline] [--no-cache]。
  • 成本约束:生成按模型、分辨率、时长及参考视频倍率计费。同一会话、同一参数组合默认只创建一次,创建入口提供 24 小时本地缓存,查询始终获取最新状态。生成失败、空结果或超时不自动换模型、重建任务或增加生成数量;下载失败只重试下载,额外生成前说明新增消耗。

输出策略

  • 始终保存完整响应,目标路径为 <cwd>/linkfox/<YYYY-MM-DD>/<session>/data/linkfox-aigc-image-to-video-<接口标识>-<timestamp>.json。<cwd> 为脚本运行时的工作目录,<session> 优先取环境变量 SESSION_ID,用于聚合同一任务的数据。禁止写入 /tmp,当前目录不可写时应报错。
  • 响应体不超过 8 KB:保存后,将完整 JSON 打印到标准输出。
  • 响应体超过 8 KB:保存后,标准输出仅展示摘要,包括顶层字段、常见计数(如 total、costToken)、最大列表字段的长度和前 3 条样本;costCredit 从已保存的响应中读取。
  • 添加 --inline 可强制全量打印到标准输出,同时仍保存文件。

先通过摘要判断数据是否足够。需要具体字段时,优先使用 jq 或 ConvertFrom-Json 从保存的 JSON 文件按需提取,避免将整份响应载入上下文。

执行规则

算力消耗预估

按模型、分辨率、时长及参考视频情况估算,具体配置与倍率见 references/api.md。上传免费 (限时);创建返回的零值不代表生成免费,最终以查询及费用响应头为准,未报告费用时说明未知。

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

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

解决认证和算力问题

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

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

约束与建议

  • requestId 为可选兼容字段;提供时原样转发,缺失时不自动生成。超时使用已接受的 taskId 恢复查询,不自动重新创建。

  • 任务被接受不等于已生成:创建入口只接受任务;查询与下载完成后才交付成品。若提供 requestId,新任务使用新值,同一任务保留原值;网络超时后不自动重提创建请求。

  • 保留源素材:本地和外部素材均先走内置 Base64 上传;只处理当前任务需要的素材。失败时停止,不擅自裁剪、压缩、改图或切换 STS/OSS 上传。沿用用户对本次素材处理的授权,不重复索取上传确认。

  • 清晰展示成品:成功图片使用 ![说明](<绝对路径>) 展示,视频使用本地文件链接或播放器;说明任务状态、下载失败和实际费用。JSON 是任务记录,不能当作生成视频交付;不读取二进制媒体来解释结果,也不向用户复述原始路径协议行。

  • 保护凭证与素材:不展示密钥、Authorization、Base64、内部工具标识或签名素材 URL,不把登录令牌、验证码或密钥写入任务 JSON、缓存或源文件。反馈只记录路径、任务标识与脱敏错误摘要,不包含私密素材内容。

  • 准确解释状态:只展示后端实际返回的信息,不推断单项生成错误或未返回的媒体属性。查询可兼容既有图像/视频任务;通用图像生成、视频编辑和翻译使用对应技能流程。

  • 认证与用量问题:出现认证失败或余额不足时停止生成,按引导处理,不探测其他模型或新增收费任务。403 权限或归属问题不能靠充值解决;短信、登录和套餐购买按引导中的用户选择执行,不自动轮询支付。

  • 保留缓存边界:创建使用 24 小时缓存,并遵守同参数只调用一次约定;轮询始终获取最新状态。下载失败仅重试下载;需要额外生成前先说明新增消耗。

使用示例

商品展示视频

用户:用这些商品图片做一段展示外观和细节的视频。

根据图片和展示目标选择支持的模型或模板,执行完整任务,下载成品后展示本地视频与实际费用。

继续等待已有任务

用户:这是刚才的任务编号,继续查看结果。

使用续查入口查询原任务,成功后下载;仍在处理时保留编号,不启动新的生成。

重试成品下载

用户:视频已经生成,但刚才下载失败。

读取已保存的成功查询 JSON,仅执行下载入口,交付成功文件并列明仍然失败的下载项。

使用反馈

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


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