linkfox-aigc-videogen-multi
根据多张参考图和提示词生成视频,支持查询当前开放模型并选择时长、声音、画面比例和分辨率,等待生成完成后交付本地视频。适用于多图生视频、多参考图视频、商品多角度展示和 multiple images to video;不适用于单图或首尾帧视频、图片生成或文本生成。
SKILL.mdskills/linkfox-aigc-videogen-multi/SKILL.md
GitHub多参考图生视频
适用范围
适用
根据多张图片综合生成动态视频,并保存生成的视频供用户使用。
场景速查
| 用户表达 | 使用场景 |
|---|---|
| 把这几张产品图做成展示视频 | 多图参考生成商品视频。 |
| 多张图片生成视频,保留不同角度 | 按参考图和动态描述准备生成。 |
| 当前有哪些多图视频模型可以选 | 查询当前开放模型及其能力。 |
| 视频还在生成,查一下原任务 | 只查询已有任务,不重复提交。 |
边界
单图或首尾帧视频使用 linkfox-aigc-videogen;图片生成使用 linkfox-aigc-imagegen;文本生成使用 linkfox-aigc-textgen。
接口清单
| 接口 | 端点 | 接口文档 | 对应脚本 | 说明 |
|---|---|---|---|---|
| 创建多参考图视频任务 | POST /aigc/multiImageVideoGenAsync |
references/api.md |
scripts/aigc_videogen_multi.py |
提交一次生成任务。 |
| 查询任务状态 | POST /aigc/taskQuery |
references/api.md |
scripts/aigc_videogen_multi.py |
查询原任务并取得结果。 |
| 查询模型枚举 | GET ${LINKFOX_AI_API_URL}/image/video/model/config/list?bizType=88 |
references/api.md | scripts/aigc_videogen_multi.py --list-models --inline |
获取当前可用模型枚举及能力。 |
| 获取上传凭证 | POST /oss/getStsVoucherByAPI |
references/file-upload.md |
scripts/upload_files.py |
本地参考图上传所需凭证;素材上传使用 OSS SDK。 |
前置条件
先确定参考图片、预期动态效果及用户选择的模型和画面要求。模型能力及参数定义见 references/api.md 和 references/model-config.md。已有公开图片链接可直接使用;本地图片或附件按 references/file-upload.md 准备,上传前须告知文件将获得公开 URL,确认内容可以公开,禁止上传敏感或私密内容。
生成与交付流程
- 先通过查询模型枚举获取当前可用模型及能力,并遵循用户选择;仅查询失败时使用文档中的静态列表兜底。
- 准备图片素材,按原顺序复用公开链接或替换为上传成功的链接。上传失败先停止并解释原因;生成脚本不自动上传,查询原任务时不重复上传。
- 按用户选择准备请求,调用生成脚本创建一次任务。普通 JSON 生成直接使用传入参数和默认策略,不额外查询或存档模型配置,不添加模型白名单校验,不静默改写参数。
- 获得任务编号后,沿用 接口参考中的轮询策略。完成后自动下载视频到当前会话的
media/,并静默存档完整响应。 - 将媒体交付标记后的本地路径提供给用户。错误或等待超时按 脚本退出码与续查 解释,保留原任务编号;只续查原任务,不自动重建任务或换模型,不在同一轮反复等待。
执行方式
- 直接调用接口:接口端点、完整参数、响应和错误码见
references/api.md。 - 脚本调用(推荐):
python scripts/aigc_videogen_multi.py '<JSON 参数>' [--inline] [--no-cache]。 - 成本约束:生成任务按所选参数动态计费。同一会话、同一参数组合只创建一次任务;脚本不读取或保存响应缓存,
--no-cache为兼容标记。失败、空结果或等待超时只续查已有任务,不自动重建或换模型。用户要求另建任务时,先说明会产生额外消耗。
输出策略
- 生成成功时,视频下载到会话
media/,标准输出为Saved full response: <本地路径数组>;将其中本地视频路径交付给用户。完整响应静默存入会话data/,不向用户展示临时媒体 URL。 - 失败或等待超时时,标准输出包含诊断文件路径及错误摘要,
dataFile指向完整诊断;存档失败时为null。JSON 诊断路径不是视频交付结果。 - 会话根目录依次尝试
ACPX_WORKSPACES首路径、当前工作目录、用户目录和系统临时目录下的linkfox/;会话路径为<root>/<YYYY-MM-DD>/<session>/,<session>优先取SESSION_ID。响应和媒体共用同一会话。 - 模型目录输出配置 JSON,完整目录存档到
data/;超过 8000 字节时默认仅输出模型名称和请求值摘要,可用--inline输出完整能力。生成模式接受--inline,但它不改变媒体交付协议。
需要诊断字段或模型能力时,使用 jq 或 ConvertFrom-Json 从保存的 JSON 按需提取;禁止读取转存的视频内容。
执行规则
算力消耗预估
生成任务按所选参数动态计费,无固定算力单价。实际用量可参考创建响应的 costToken,以实际扣除为准;该字段缺失时脚本记录的 0 不表示免费。
声明:算力消耗以实际扣除为准;如因需要调整算力消耗标准,恕不另行通知。最终解释权归 LinkFox 官方所有。
用户会因算力消耗而支付费用。需要高频调用或用户对消耗量预期不足时,提醒用户,并由用户决定是否继续。
解决认证和算力问题
出现以下情况时,按 references/onboarding.md 的指引处理:
- 未配置接口密钥:
LINKFOX_AGENT_API_KEY和LINKFOXAGENT_API_KEY均为空。 - HTTP 状态码为
401或402。 - 响应提示算力或余额不足、计费不足、配额超限、套餐到期或需要充值。英文错误消息也按其含义判断。
约束与建议
- 异步业务专用约定:生成成功时将媒体交付标记后的本地路径交给用户;失败时查看错误摘要与诊断文件。模型目录输出配置数据,避免误当作媒体结果。缓存、会话目录和 CLI 约定见 运行约定。
- 模型展示:介绍、推荐、确认和解释错误时,仅使用动态目录的
name;查询失败时使用 静态模型能力表 的说明名称。禁止向用户展示 videoType、provider、模型 code、内部请求值或渠道名称;MiniMax H3 的多个渠道只展示为 MiniMax H3。 - 选择建议:一般多图参考可优先考虑可灵Omni;需要默认 2K 画面时可考虑 MiniMax H3。仍以当前目录和任务需求为准,不将静态表或路由示例当作名称白名单。没有合法默认值时让用户选择,不自动改参数或换模型。
- 交付展示:只展示转存后的本地视频路径;禁止读取视频文件内容、展示 base64 或向用户提供原始 API 的带签名临时 URL。生成时间通常较长,应说明处理中状态。
- 状态解释:区分客户端停止等待、服务端失败和媒体下载失败;等待超时不能解释为后端失败或已回补。空体和非 JSON 仅说明上游响应异常,不编造模型不可用原因。
- 能力与执行分离:动态能力用于介绍和选择,不改变既有请求值、业务范围、默认模型、缺参追问或普通生成链路。模型与网关地址独立配置,测试环境须同时配置两个地址,详见 模型目录参考。
- 避免重复消耗:创建任务只尝试一次;查询和素材准备遇到错误时,按对应接口参考处理。
使用示例
商品多角度视频
用户:用这几张商品图做一个多角度展示视频。
查询可用模型并说明选择,按用户要求准备素材与动态描述,提交一次任务,完成后交付本地视频。
原任务继续查询
用户:刚才的任务等太久了,再查一下。
保留原任务编号,按接口参考只查询原任务;说明当前状态或交付已完成的视频,不重新创建。
使用反馈
当技能有BUG,或技能描述有错误/疏漏/歧义/表述模糊,或技能结果与用户预期不符,或用户表达不满/赞扬,或发现其他可改进之处时,按 references/api.md#Feedback 的指引反馈,不要打断用户当前流程。
更多优质、专业的跨境电商技能,请访问 LinkFox Skill。