参考视频

参考视频用来指定动作、运镜或画面节奏。地址必须是 http 或 https，这个地址要能从公网直接下载。本地文件和 data: 地址不会被采用。

提交地址

接口是 POST https://api.52pay.com/v1/videos。请求头带令牌，Content-Type 用 application/json。令牌分组选「视频模型」。

Seedance 怎么传

下面三种写法等价，用在 seedance-2.0、seedance-2.0-mini、seedance-2.0-fast、seedance-2.5。

• referenceVideos：字符串数组，每项一条视频地址。
• input_references：对象数组，type 为 video_url。
• content：数组里放 type 为 video_url 的一项，role 为 reference_video。文字放在 type 为 text 的项里。

只传一个地址时，也可以把 mp4、mov、webm 放在 input_reference。这种地址按参考视频处理，不会当成图片。

数量

Mini 和 Fast 最多 3 段视频、9 张图、3 段音频。seedance-2.5 最多 10 段视频、30 张图、10 段音频。秒数和分辨率以模型广场为准。

seedance-2.5_v3 不收视频

seedance-2.5_v3 只收参考图，不收参考视频。把视频放进请求会直接拒绝。

请求示例

curl https://api.52pay.com/v1/videos \  -H "Authorization: Bearer sk-你的令牌" \  -H "Content-Type: application/json" \  -d @body.json

body.json：

{  "model": "seedance-2.0-mini",  "prompt": "保持参考视频的运镜，把主体换成白猫",  "seconds": "8",  "resolution": "480p",  "ratio": "16:9",  "referenceVideos": ["https://example.com/ref.mp4"]}

写成 content 时同样有效：

{  "model": "seedance-2.0-mini",  "seconds": "8",  "resolution": "480p",  "ratio": "16:9",  "content": [    { "type": "text", "text": "保持参考视频的运镜，把主体换成白猫" },    {      "type": "video_url",      "video_url": { "url": "https://example.com/ref.mp4" },      "role": "reference_video"    }  ]}

可灵 4.0

kling-4.0 用 input_references。视频的 type 是 video_url，图片是 image_url。最多 5 段视频、10 张图、3 段音频。

不用写英文标记

不用在提示词里写这些标记。提交时会按素材顺序自动补上，提示词继续用中文即可。

{  "model": "kling-4.0",  "prompt": "保持参考视频的运镜，角色用参考图的外观",  "seconds": "4",  "resolution": "720p",  "ratio": "16:9",  "input_references": [    { "type": "video_url", "url": "https://example.com/ref.mp4" },    { "type": "image_url", "url": "https://example.com/role.png" }  ]}

配套阅读

• 视频模型
• 原生 API 调用
• 模型广场