LinkfoxAI agent and documentation index

Fetch the complete documentation index at: /llms.txt

Read when and how to use LinkfoxAI at: /agent-instructions.txt

Machine-readable API description: LinkfoxAI OpenAPI specification

Use this file to discover all available pages before exploring further.

LinkfoxAI logo
开始使用
API对接文档

非高峰图转视频

POST/image/v3/make/offPeak/imageToVideoapplication/json

请求体

minimax-h3-lite 默认有声,不支持关闭;请省略 voice,无需提供参考音频。

generationModestring可选默认normal
生成模式:normal(默认)为普通模式;advanced 为高级模式,先生成分镜图,再生成视频。
productNamestring可选
商品名称,高级模式使用。
supplementaryRequirementsstring可选
制作补充要求,高级模式使用。
soundRequirementsstring可选
声音要求,高级模式使用。
textRequirementsstring可选
画面文字要求,高级模式使用。
imageUrlstring可选
原图地址。当前支持的 minimax-h3-lite 不支持该字段,必须传 imageList
imageListarray[string]必填
多图参考图列表;minimax-h3-lite 必须传,1~9 张
videoarray[string]可选
参考视频 URL 列表,最多 1 段;支持的模型见图转视频「参考视频」,当前支持的 minimax-h3-lite 不支持参考视频
videoTypestring必填
模型类型;当前仅支持 minimax-h3-lite,取值规则见图转视频「各模型参数支持情况」
videoTimenumber必填
视频时长(秒);具体支持值见图转视频「各模型参数支持情况」
promptstring条件必填
普通模式为视频提示词,不传 templateKey 时必填;高级模式为可选创意描述。最多 4000 字符
promptOptimizerboolean可选默认false
是否开启提示词优化
true:开启,false:不开启
isProboolean可选
是否开启高质量 / Pro 模式(已废弃,建议改用 resolution)
resolutionstring条件必填
视频分辨率;具体支持值见图转视频「各模型参数支持情况」
voiceboolean可选
minimax-h3-lite 默认有声,不支持关闭;请省略此字段。
lastFrameImageUrlstring可选
尾帧图地址;支持的模型见图转视频「各模型参数支持情况」
aspectRatiostring条件必填
视频比例;具体支持值见图转视频「各模型参数支持情况」
camerastring可选
运镜参数;支持的模型及可选值见图转视频「各模型参数支持情况」
templateKeystring可选
视频模板标识,与高级模式互斥;普通模式传入后自动生成提示词,无需再传 prompt
productInfostring可选
商品信息,供模板模式或高级模式使用。高级模式传入非空内容时跳过商品分析,不传则自动分析商品图;分镜流程费用相同
languagestring可选默认中文
目标语言(模板模式或高级模式使用);高级模式未传时默认中文
saleCountrystring可选
销售国家/地区(模板模式或高级模式使用),无默认值
useAssetWhitelistboolean可选默认true
与普通图转视频共用的 Seedance 素材加白开关;当前非高峰仅支持 MiniMax H3-Lite,该参数不触发加白。详见Seedance 素材加白。
各参数的取值边界(videoTime 可选时长、resolution 可选分辨率、aspectRatio 可选比例、参考图张数上限)以及图片入参规则、参考视频规则,均与图转视频相同,按所选模型的配置校验,本文不再重复。

高级模式

限时免费:高级模式的分镜生成流程限时免费,视频生成仍按所选模型的原有标准扣点。

在普通请求中增加 "generationMode": "advanced",任务开始生成后会先生成分镜图,再生成视频。其他参数和结果查询方式不变,示例见图转视频高级模式。

请求示例

示例:minimax-h3-lite — 多图(imageList)15 秒竖版

JSON
{
  "imageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoType": "minimax-h3-lite",
  "videoTime": 15,
  "prompt": "展示商品外观与使用场景,镜头缓慢推进",
  "resolution": "768P",
  "aspectRatio": "9:16"
}

提交后返回什么

提交成功后返回任务编号 data.id,表示任务已创建,结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果,每次查询至少间隔 10 秒。data.status=3 表示成功;若生成了图片或视频,从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

非高峰任务

非高峰任务还会返回以下字段:

字段说明
submitMode固定为 OFF_PEAK
deadlineAt最晚完成时间,毫秒时间戳
  • 创建成功后任务停留在排队中(status = 1),被调度放行后才进入生成中(status = 2)。创建后不会立即执行:落在非高峰时段内时从下一个调度周期开始按资源水位放行,落在时段外时等到下一个时段开始,等待期最长 48 小时,属预期行为,不是任务卡住。
  • 超过 deadlineAt 仍未放行时任务置为失败,errorCode = OFF_PEAK_DEADLINE_EXCEEDED,已扣算力自动退回。

常见问题

  • 报「该模型不支持非高峰模式」:当前只有 minimax-h3-lite 支持非高峰模式,其他模型(含已发布模型)调用本接口都会返回该错误,请改用图转视频。
  • 报「视频模型配置未发布」:videoType 不在当前环境已发布的模型配置中,与普通图转视频的报错一致。
  • 任务一直是排队中:非高峰任务在非高峰时段内按资源水位与实时任务让路规则放行,提交后如未落在时段内需等到下一个时段开始,高峰期等待时间较长属正常;等待不会超过 48 小时。
  • 扣点怎么算:先按模型 + 时长 + 分辨率算出原价,再按 5 折向上取整。例如 minimax-h3-lite 768P 15 秒原价 45 点,⌈45 × 0.5⌉ = ⌈22.5⌉ = 23,扣 23 点。
  • 和普通图转视频的模型、参数能通用吗:参数与模型是同一套;但当前只有 minimax-h3-lite 在本接口可用。同一个 videoType 的视频生成费用在普通接口按原价扣点,在本接口按 5 折扣点;高级模式的分镜流程费用不参与折扣。

参数细节见图转视频开放平台对接文档。

扣费标准

按图转视频中 minimax-h3-lite 的当前价格计算,视频生成扣点数为 向上取整(视频原价 × 0.5)。高级模式还需加上一次分镜流程费用,分镜费用不参与折扣。

分镜流程费用与页面同步,当前免费(0 算力点),后续标准为 50 算力点/次,具体生效以正式发布公告为准。详见高级模式计费。

创建上限

配置项上限
创建中 / 生成中任务上限100 个