怎么用首帧和尾帧图片控制视频的开头和结尾

在 RelayDance 上,你可以通过 POST /v1/video/generations 接口,把首帧和尾帧图片放入 metadata.content[] 数组,并在 prompt 里用 @image1 到 @imageN 引用它们,从而控制视频的开头与结尾画面。每个请求最多可携带 9 张参考图片。接口为 OpenAI 兼容协议,base_url 改为 https://relaydance.com/v1 即可调用,详情见 relaydance.com/docs。

如何在请求中提供首帧和尾帧图片

首帧和尾帧图片需要放入 metadata.content[],并在 prompt 中通过 @image1、@image2 等标记引用。你把第一张图片设为开头画面,把最后一张设为结尾画面,再在提示词中描述从首帧过渡到尾帧的运动。单个请求最多支持 9 张参考图片、3 段参考视频和 3 条音轨,单条视频片段时长可达 15 秒。据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」,因此你无需更换现有的 OpenAI 客户端库。

提交首尾帧视频任务的步骤

提交带首尾帧的视频任务分为三步:构建请求、发送请求、轮询结果。

1. 在 relaydance.com/console 创建 API Key,设置请求头 Authorization: Bearer YOUR_API_KEY。
2. 发送 POST /v1/video/generations,填入 model、prompt(引用 @image1 到 @imageN)、seconds,并在 metadata.content[] 中放入首帧与尾帧图片,可选设置 ratio、resolution、generate_audio、callback_url。
3. 轮询 GET /v1/video/generations/{task_id},直到 status 变为 succeeded 或 failed,成功结果中包含视频 url;也可设置 metadata.callback_url 使用 Webhook 模式,最终状态会 POST 到你的服务器。

首尾帧视频的价格与计费

带首帧和尾帧的视频按生成的视频计费,采用按量付费(pay-as-you-go)。不同分辨率的 Seedance 2.0 单价不同:720p 约 $0.190 / 秒,1080p 约 $0.470 / 秒,Seedance Fast 约 $0.152 / 秒,原生 4K 约 $4.90 / 5 秒条。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,因此若首尾帧任务返回 failed,你不会被扣费。最新的分模型费率见 relaydance.com/models。

参考媒体的数量限制

每个请求对参考媒体有明确上限:最多 9 张参考图片、3 段参考视频、3 条音轨,单条片段时长最长 15 秒。首帧和尾帧属于其中的参考图片,因此在 9 张的额度内你可以同时提供开头图、结尾图以及其他风格或角色参考图。所有图片都要放进 metadata.content[],并在 prompt 中用 @image1 到 @imageN 逐一引用。若需要生成静态图片,可改用 POST /v1/images/generations 接口。支付方式支持 USDT 与 Stripe 卡。

常见问题

问:首帧和尾帧图片应该放在哪个字段?

答:放在 metadata.content[] 数组中,并在 prompt 里用 @image1 到 @imageN 引用。单个请求最多支持 9 张参考图片。

问:任务失败会扣费吗?

答:不会。据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,只有生成成功的视频才计费。

问:接入是否需要更换 SDK?

答:不需要。接口为 OpenAI 兼容,只需把 base_url 改为 https://relaydance.com/v1,并保留现有的 OpenAI SDK 即可调用。