非高峰图转视频
/image/v3/make/offPeak/imageToVideoapplication/json请求体
minimax-h3-lite 默认有声,不支持关闭;请省略 voice,无需提供参考音频。
与图转视频 V3使用相同参数。选择本接口即为非高峰生成,无需传 submitMode;普通图转视频接口不会自动切换为非高峰模式。
videoTypestring必填minimax-h3-lite。imageUrlstring可选minimax-h3-lite 请使用 imageList。其他模型按普通接口的图片入参规则校验。videoTimeinteger可选resolutionstring可选aspectRatiostring可选templateKeystring可选generationModestring可选默认normaladvanced 为先生成分镜图、再生成视频的高级模式productNamestring可选productInfostring可选supplementaryRequirementsstring可选soundRequirementsstring可选textRequirementsstring可选languagestring可选saleCountrystring可选promptOptimizerboolean可选默认falsevoiceboolean可选minimax-h3-lite 默认有声,不支持关闭;请省略此字段。lastFrameImageUrlstring可选camerastring可选isProboolean可选resolution。videoarray[string]可选audioarray[string]可选referenceDocumentobject可选useAssetWhitelistboolean可选默认trueimageListarray[string]条件必填minimax-h3-lite 必须使用该字段,图片地址不能为空;数量上限见普通接口的模型能力表。promptstring条件必填templateKey 时必填;高级模式为可选创意描述。长度限制沿用普通接口。模型能力与折扣按图转视频独立配置。模型没有有效非高峰折扣时拒绝创建;参考素材组合、比例、时长和分辨率均沿用普通图转视频规则。
高级模式
增加 "generationMode": "advanced",任务放行后按原有流程按需分析商品、生成分镜,再生成视频。不能同时使用 templateKey。详细参数和示例见图转视频高级模式。
非高峰折扣仅用于视频生成费用,高级模式分镜流程费用另计,不参与非高峰折扣;费用及免费期见高级模式计费。
请求示例
以下以已开通非高峰的 minimax-h3-lite 为例,实际规格以当前模型配置为准:
{
"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 | 最晚调度放行时间,Unix 毫秒时间戳;不是视频完成时间。 |
- 创建后为排队中(
status=1),按非高峰时段、资源水位和实时任务优先规则放行,进入执行后为生成中(status=2)。 - 最长等待 48 小时;超过
deadlineAt仍未放行时失败,errorCode=OFF_PEAK_DEADLINE_EXCEEDED,自动退回实际预扣算力。 - 放行后继续执行正常生成流程,不承诺 48 小时内完成。
常见问题
- 报“该模型不支持非高峰模式”:该模型在图转视频中未配置有效非高峰折扣,请联系服务方确认,或改用普通图转视频。
- 报“视频模型配置未发布”:请确认当前环境已发布对应的图转视频模型。
- 一直排队是否需要重提:不需要。请查询原任务,重复提交会新建任务并再次计费。
- 和其他非高峰视频接口的折扣相同吗:不一定。图转视频、带货口播和视频复刻分别读取各自模型的折扣配置。
扣费标准
视频生成费用为 向上取整(普通图转视频 API 原价 × 当前模型的非高峰折扣率)。0 或未配置表示不支持非高峰;高级模式还需加上分镜流程费用,分镜费用不参与折扣。
例如本次视频原价 45 点、折扣配置为 0.5(5 折),视频实际预扣 ⌈45 × 0.5⌉ = 23 点。该数值仅演示取整方式,不代表所有模型固定 5 折。失败按既有规则回补实际扣点,任务结果中的扣点以服务端为准。
创建上限
| 配置项 | 上限 |
|---|---|
| 创建中 / 生成中任务上限 | 100 个 |