linkfox-aigc-image-to-video
通过单图或多图生成视频,支持参考视频、商品展示模板、尾帧和声音等模型能力,并查询任务、下载成品。适用于图转视频、商品展示视频和 image to video;不适用于通用图像生成、视频编辑、视频翻译或其他创作操作。
SKILL.mdskills/linkfox-aigc-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 约定见接口定义。
执行流程
- 阅读接口定义,按用户需求选择当前模型与模板;面向用户使用友好模型名称,构造请求时使用文档明确支持的模型代码与默认值。
- 业务字段必须嵌套在非空
params对象中。完整任务运行python <skill-root>/scripts/run_task.py '<JSON 参数>'。它先上传每个不同来源的素材,复用本次映射并保留列表顺序;全部上传成功后只创建一次任务。较长输入、文件和标准输入的用法见接口定义。 - 保存已接受的任务编号,等待并轮询任务状态。超时保留原任务,用
python <skill-root>/scripts/run_task.py --task-id <已保存编号>继续查询,不重新上传或创建。查询失败按实际错误处理,生成失败不自动换模型、重建任务或增加生成数量。 - 成功后下载结果媒体,保存终态查询响应及资产清单,记录实际费用与下载失败项。下载失败只运行
python <skill-root>/scripts/download_results.py <已保存的成功查询JSON>重试下载,不重新生成。 - 从 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。