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/salesVideoapplication/json

请求体

与带货口播 V3使用相同参数。选择本接口即为非高峰生成,无需传 submitMode;普通带货口播接口不会自动切换为非高峰模式。

videoTypestring必填
模型 API Code,必须在带货口播业务中已发布且支持非高峰生成;例如 minimax-h3-lite。
imageListarray[string]必填
商品参考图 URL 列表,至少 1 张;数量及素材限制沿用所选模型的普通带货口播规则。
videoTimeinteger可选
视频时长(秒);可选值及默认值见普通接口的模型能力表。
resolutionstring可选
视频分辨率;按所选模型配置校验,建议显式传入。
aspectRatiostring可选
视频比例;按所选模型配置校验。
templateKeystring可选
视频模板标识,传入后使用模板生成提示词。
languagestring可选
视频对白、旁白、字幕及屏幕文字的目标语言,如 vi 或 越南语。
productInfostring可选
商品补充信息,供模板模式使用。
saleCountrystring可选
销售国家或地区。
isProboolean可选默认false
与普通接口相同的 Pro 模式,建议使用 resolution
useAssetWhitelistboolean可选默认true
与普通带货口播共用的 Seedance 素材加白开关,省略或传 null 均使用默认值;仅实际使用 Seedance 模型时生效,MiniMax H3-Lite 不触发加白。详见Seedance 素材加白。
promptstring条件必填
口播文案或视频提示词,与 templateKey 至少传一个;常规模型最多 2000 字符,其他模型限制见普通接口。

模型能力与折扣按带货口播独立配置。模型没有有效非高峰折扣时拒绝创建;参考素材、比例、时长和分辨率均沿用普通带货口播规则。

传入 templateKey 时,任务放行后按原有模板流程生成提示词,再生成视频。模板参数及用法见普通带货口播。声音随所选模型生成,本接口不提供独立声音开关或参考音频输入。

请求示例

以下以已开通非高峰的 minimax-h3-lite 为例,实际规格以当前模型配置为准:

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",
  "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 个