API对接文档
非高峰图转视频
POST
/image/v3/make/offPeak/imageToVideoapplication/json请求体
minimax-h3-lite 默认有声,不支持关闭;请省略 voice,无需提供参考音频。
generationModestring可选默认normal生成模式:
normal(默认)为普通模式;advanced 为高级模式,先生成分镜图,再生成视频。productNamestring可选商品名称,高级模式使用。
supplementaryRequirementsstring可选制作补充要求,高级模式使用。
soundRequirementsstring可选声音要求,高级模式使用。
textRequirementsstring可选画面文字要求,高级模式使用。
imageUrlstring可选原图地址。当前支持的
minimax-h3-lite 不支持该字段,必须传 imageListimageListarray[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可选视频模板标识,与高级模式互斥;普通模式传入后自动生成提示词,无需再传
promptproductInfostring可选商品信息,供模板模式或高级模式使用。高级模式传入非空内容时跳过商品分析,不传则自动分析商品图;分镜流程费用相同
languagestring可选默认中文目标语言(模板模式或高级模式使用);高级模式未传时默认中文
saleCountrystring可选销售国家/地区(模板模式或高级模式使用),无默认值
useAssetWhitelistboolean可选默认true与普通图转视频共用的 Seedance 素材加白开关;当前非高峰仅支持 MiniMax H3-Lite,该参数不触发加白。详见Seedance 素材加白。
各参数的取值边界(videoTime可选时长、resolution可选分辨率、aspectRatio可选比例、参考图张数上限)以及图片入参规则、参考视频规则,均与图转视频相同,按所选模型的配置校验,本文不再重复。
高级模式
限时免费:高级模式的分镜生成流程限时免费,视频生成仍按所选模型的原有标准扣点。
在普通请求中增加 "generationMode": "advanced",任务开始生成后会先生成分镜图,再生成视频。其他参数和结果查询方式不变,示例见图转视频高级模式。
请求示例
示例:minimax-h3-lite — 多图(imageList)15 秒竖版
{
"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-lite768P 15 秒原价 45 点,⌈45 × 0.5⌉ = ⌈22.5⌉ = 23,扣 23 点。 - 和普通图转视频的模型、参数能通用吗:参数与模型是同一套;但当前只有
minimax-h3-lite在本接口可用。同一个videoType的视频生成费用在普通接口按原价扣点,在本接口按 5 折扣点;高级模式的分镜流程费用不参与折扣。
参数细节见图转视频开放平台对接文档。
扣费标准
按图转视频中minimax-h3-lite的当前价格计算,视频生成扣点数为向上取整(视频原价 × 0.5)。高级模式还需加上一次分镜流程费用,分镜费用不参与折扣。
分镜流程费用与页面同步,当前免费(0 算力点),后续标准为 50 算力点/次,具体生效以正式发布公告为准。详见高级模式计费。
创建上限
| 配置项 | 上限 |
|---|---|
| 创建中 / 生成中任务上限 | 100 个 |