非高峰带货口播
/image/v3/make/offPeak/salesVideoapplication/json请求体
与带货口播 V3使用相同参数。选择本接口即为非高峰生成,无需传 submitMode;普通带货口播接口不会自动切换为非高峰模式。
videoTypestring必填minimax-h3-lite。imageListarray[string]必填videoTimeinteger可选resolutionstring可选aspectRatiostring可选templateKeystring可选languagestring可选vi 或 越南语。productInfostring可选saleCountrystring可选isProboolean可选默认falseresolutionuseAssetWhitelistboolean可选默认truepromptstring条件必填templateKey 至少传一个;常规模型最多 2000 字符,其他模型限制见普通接口。模型能力与折扣按带货口播独立配置。模型没有有效非高峰折扣时拒绝创建;参考素材、比例、时长和分辨率均沿用普通带货口播规则。
传入 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",
"language": "中文"
}提交后返回什么
提交成功后返回任务编号 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 个 |