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对接文档

视频复刻V3

POST/image/v3/make/videoRecloneapplication/json

请求体

videoTypestring必填
模型类型，支持值见下方模型能力表
refVideoUrlstring必填
参考视频的公网 URL，用于分析镜头、节奏和脚本；生成时使用分析得到的提示词与商品参考图。链接需长期有效，避免使用短期签名 URL。
refImageListarray必填
参考商品图 URL 列表，至少 1 张；数量上限按模型区分，见下方各模型参数支持情况。
videoTimeinteger可选
视频时长（秒）；支持值和默认值见下方各模型参数支持情况。
resolutionstring可选
视频分辨率，可选值和默认值见下方各模型参数支持情况。
aspectRatiostring可选
视频比例，可选值见下方各模型参数支持情况
productInfostring可选
补充商品文字信息，用于辅助 AI 分析，最多 2500 字符。
intentDescriptionstring可选
复刻意图描述，最多 2500 字符，超限拒绝；用于自动分析和最终提示词生成。
saleCountrystring必填
销售国家（如 CN、US）
targetLanguagestring必填
目标语言（如 zh、en）
promptstring可选
最终提示词，最多 2000 字符。传入后将跳过 AI 分析直接按该提示词生成视频；不传则由系统自动分析参考视频与商品图后生成。
useAssetWhitelistboolean可选默认true
是否使用素材库加白；省略或 null 同默认。true 使用素材库资产，false 直接提交素材 URL；预检规则及人脸审核风险见下方Seedance 素材加白。

Seedance 素材加白

useAssetWhitelist 用于选择参考素材进入素材库加白，还是直接以 URL 提交模型，放在本页请求体中，与 videoType 同级。支持情况以所选模型为准。

取值具体用途与提交方式预检规则
true（默认）需要入库的参考图片/视频先上传素材库，再用资产 ID 提交，适合需要素材库人像加白的场景。入库参考图片按素材库限制整组预检后再上传；视频保留已有时长、数量、格式、大小等业务约束，不套用图片像素规则。
false关闭自动入库和历史资产 ID 复用，直接使用素材 URL，适合希望按当前模型规格直传的场景。按当前模型配置的尺寸、比例、大小、格式、时长等限制预检。

素材库参考图片要求：宽和高均为 300～6000 像素（含边界），宽高比 2:5～5:2（含边界），单张小于 30 MiB（供应商文档标为 30 MB）；支持 JPEG（含 JPG）、PNG、WEBP、TIFF（含 TIF）、GIF、HEIC/HEIF。该规格仅用于图片入库，素材数量、时长及组合等业务约束仍按模型校验。依据：私域虚拟人像素材资产库使用指南。

人脸审核风险：关闭加白时，包含人脸或真人肖像的素材可能被供应商审核拒绝；开启加白仍须通过素材库和模型审核，不能保证成功。尺寸等预检通过不代表内容审核通过。

如需关闭加白，在本页完整请求中加入 "useAssetWhitelist": false；省略或传 null 均按 true 处理。

各模型参数支持情况

声音随所选模型重新生成，不保证保留参考视频原声；本接口不提供独立声音开关或参考音频输入，请勿传入 voice 或 audio。

正在读取模型配置...

参数使用建议

  • refVideoUrl 必须为稳定可访问的公网 URL，Gemini 在异步分析阶段才访问，短期签名 URL 可能已过期。
  • refImageList 中的图片在提交任务时同步下载，若图片无法访问，任务创建立即报错，请确保图片地址长期有效。
  • productInfo 为可选的文字补充，提供商品名称、卖点等信息可提升复刻效果（仅在未传 prompt、走自动分析时生效）。
  • prompt 为可选的最终提示词：传了则跳过 AI 分析直接生成视频，适合已有分镜/脚本、或对自动分析结果二次编辑后再提交的场景；不传则走完整分析流程。
  • doubao-seedance-2-0-fast / doubao-seedance-2-0-mini 传入 resolution=1080P 会报错，建议传 480P 或 720P。
  • aspectRatio 不传时各模型使用厂商默认比例。

请求示例

示例1：doubao-seedance-2-0

JSON
{
  "videoType": "doubao-seedance-2-0",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoTime": 10,
  "resolution": "720P",
  "aspectRatio": "9:16",
  "productInfo": "便携式榨汁杯，300W 强劲电机，Type-C 充电",
  "saleCountry": "CN",
  "targetLanguage": "zh"
}

示例2：doubao-seedance-2-0-fast

JSON
{
  "videoType": "doubao-seedance-2-0-fast",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoTime": 10,
  "resolution": "720P",
  "aspectRatio": "9:16"
}

示例3：传入 prompt（跳过 AI 分析，直接生成）

JSON
{
  "videoType": "doubao-seedance-2-0",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoTime": 10,
  "resolution": "720P",
  "aspectRatio": "9:16",
  "prompt": "开场特写榨汁杯外观，随后展示 Type-C 充电与 40 秒出汁过程，结尾口播强调便携通勤场景"
}

示例4：doubao-seedance-2-5（豆包 Seedance 2.5）— 30 秒长视频

JSON
{
  "videoType": "doubao-seedance-2-5",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg",
    "https://example.com/product3.jpg"
  ],
  "videoTime": 30,
  "resolution": "720P",
  "aspectRatio": "16:9",
  "productInfo": "智能手表，支持心率监测、睡眠追踪、50米防水"
}

示例5：happyhorse-v2（HappyHorse）— 1080P 高清

JSON
{
  "videoType": "happyhorse-v2",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product1.jpg",
    "https://example.com/product2.jpg"
  ],
  "videoTime": 15,
  "resolution": "1080P",
  "aspectRatio": "9:16",
  "productInfo": "时尚运动鞋，透气网面，轻量化设计"
}

示例6：viduq4-preview（Vidu Q4 Preview）

JSON
{
  "videoType": "viduq4-preview",
  "refVideoUrl": "https://example.com/ref-video.mp4",
  "refImageList": [
    "https://example.com/product-main.jpg",
    "https://example.com/product-detail.jpg"
  ],
  "videoTime": 5,
  "resolution": "1080P",
  "aspectRatio": "9:16",
  "productInfo": "便携式榨汁杯，Type-C 充电",
  "saleCountry": "CN",
  "targetLanguage": "zh"
}

提交后返回什么

提交成功后返回任务编号 data.id，表示任务已创建，结果还需等待生成。请保存编号。查看返回示例。

查询生成结果

用任务编号 data.id 调用获取作图结果，每次查询至少间隔 10 秒。data.status=3 表示成功；若生成了图片或视频，从 data.resultList[].url 获取地址。data.status=4 表示失败。查看统一示例。

常见问题

  • 报参数错误：优先检查 videoType 是否为上方列出的支持值，videoTime 和 refImageList 数量是否符合对应模型的限制。
  • doubao-seedance-2-0-fast / doubao-seedance-2-0-mini 报分辨率错误：两者均不支持 1080P，请传 480P 或 720P。
  • 报比例错误：各模型支持的 aspectRatio 值见上方各模型参数支持情况，传入不在列表内的值会报错。
  • 任务创建时报图片错误：参考图片地址不可访问。refImageList 中的图片在提交时同步下载，请确保图片外网可访问。
  • 参考视频无法分析：refVideoUrl 必须为稳定公网 URL，短期签名 URL 在异步分析阶段可能已失效。
  • 任务失败：检查图片/视频地址是否合规、套餐算力是否充足。
  • 结果为空或超时：延长轮询时间；未传 prompt 时视频复刻涉及多步 AI 分析，通常比图片任务耗时更长。传入 prompt 可跳过分析、缩短等待。
  • 想自定义分镜/脚本：传入 prompt 即可按自定义提示词直接生成，无需等待自动分析。

扣费标准

正在读取当前模型扣点...

按模型、分辨率和视频时长扣点；每秒价乘视频时长，按次价或时长档位价直接作为任务点数。

创建上限

配置项上限
创建中 / 生成中任务上限100 个