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

请求体

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

videoTypestring必填
模型 API Code,必须在视频复刻业务中已发布且支持非高峰生成;例如 minimax-h3-lite。
refVideoUrlstring必填
参考视频的公网 URL,用于自动分析镜头、节奏和脚本;请使用长期有效地址,覆盖非高峰等待与后续执行。
refImageListarray[string]必填
商品参考图 URL 列表,至少 1 张;数量上限见普通接口的模型能力表。
videoTimeinteger可选
视频时长(秒);可选值及默认值见普通接口的模型能力表。
resolutionstring可选
视频分辨率;按所选模型配置校验,建议显式传入。
aspectRatiostring可选
视频比例;按所选模型配置校验。
productInfostring可选
辅助 AI 分析的商品文字信息,最多 2500 字符。
intentDescriptionstring可选
复刻意图,最多 2500 字符;自动分析时使用。
saleCountrystring可选
销售国家或地区,如 CN、US;无默认值,用于复刻提示词的本地化调整。
targetLanguagestring可选
目标语言,如 zh、en;无默认值,用于复刻提示词的语言调整。
promptstring可选
最终视频提示词;传入后跳过 AI 分析,仍需提交参考视频与商品图。常规模型最多 2000 字符,其他模型限制见普通接口。
useAssetWhitelistboolean可选默认true
与普通视频复刻共用的 Seedance 素材加白开关,省略或传 null 均使用默认值;仅实际使用 Seedance 模型时生效,MiniMax H3-Lite 不触发加白。详见Seedance 素材加白。

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

不传 prompt 时,任务放行后按原有流程分析参考视频与商品图、生成提示词,再生成视频;传入 prompt 时跳过自动分析,仍需提交参考视频与商品图。详细参数和示例见普通视频复刻。声音随所选模型重新生成,不保证保留参考视频原声,本接口不提供独立声音开关或参考音频输入。

请求示例

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

JSON
{
  "refVideoUrl": "https://example.com/reference-video.mp4",
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoType": "minimax-h3-lite",
  "videoTime": 15,
  "resolution": "768P",
  "aspectRatio": "9:16",
  "productInfo": "便携榨汁杯,适合通勤和健身场景",
  "intentDescription": "参考原视频的镜头节奏,展示当前商品的细节和使用方式",
  "saleCountry": "US",
  "targetLanguage": "en"
}

提交后返回什么

提交成功后返回任务编号 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 个