怎么通过 API 生成 TikTok 和 Reels 用的 9:16 竖屏视频

通过 RelayDance 的 OpenAI 兼容接口,向 POST /v1/video/generations 提交任务即可生成 9:16 竖屏视频:在请求中设置 model、prompt、seconds,并在 metadata 里把 ratio 设为 9:16、指定 resolution,然后用 GET /v1/video/generations/{task_id} 轮询直到 status 为 succeeded,从结果中取回 video url。Seedance 2.0 720p 约 $0.190 / 秒。

怎么配置接口和认证

只需把 base_url 指向 RelayDance 并保留现有 OpenAI SDK 即可调用。据 relaydance.com/docs 官方文档,「将 base_url 改为 https://relaydance.com/v1 并保留 OpenAI SDK 即可调用」。认证使用请求头 Authorization: Bearer YOUR_API_KEY,API Key 可在 https://relaydance.com/console 创建。接口协议为 OpenAI 兼容,base_url 固定为 https://relaydance.com/v1。支持的模型包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 视频模型,以及 Grok Imagine 视频与图像模型。付费方式支持 USDT 与 Stripe 银行卡,计费为按生成视频用量付费。无需 BytePlus 企业账号或 KYC。

怎么提交 9:16 竖屏视频任务

向 POST /v1/video/generations 发送请求,并在 metadata.ratio 中设为 9:16 即可输出竖屏比例。请求体包含 model、prompt、seconds,以及 metadata 中的 ratio、resolution、generate_audio、callback_url 和 content[] 参考媒体。参考媒体放入 metadata.content[],在 prompt 中用 @image1 到 @imageN 引用。每次请求可包含最多 9 张参考图、3 段参考视频和 3 条音轨,片段长度最长 15 秒。提交后使用 GET /v1/video/generations/{task_id} 轮询,status 为 succeeded 或 failed 时结束,结果中包含 video url。

怎么选择分辨率和估算成本

竖屏视频的成本按所选模型和分辨率的每秒单价计算,实时费率见 https://relaydance.com/models。下表列出部分单价(来源 relaydance.com/models):

据 relaydance.com 官方文档,「失败或报错的请求一律不计费」,因此调试竖屏参数时失败任务不会产生费用。计费为按生成视频用量付费。

生成 9:16 竖屏视频的操作步骤

按以下步骤即可完成一次竖屏视频生成:

1. 在 https://relaydance.com/console 创建 API Key。
2. 将 OpenAI SDK 的 base_url 改为 https://relaydance.com/v1,请求头设置 Authorization: Bearer YOUR_API_KEY。
3. 调用 POST /v1/video/generations,填写 model、prompt、seconds,并在 metadata 中设置 ratio 为 9:16 与 resolution。
4. 如需参考媒体,放入 metadata.content[],并在 prompt 中用 @image1 引用。
5. 轮询 GET /v1/video/generations/{task_id},或设置 metadata.callback_url 使用 Webhook 回调;status 为 succeeded 后取回 video url。

常见问题 FAQ

问:竖屏比例在哪里设置? 答:在请求的 metadata.ratio 中设为 9:16,TikTok 与 Reels 竖屏即按此比例输出,同时可用 resolution 指定分辨率。

问:任务失败会扣费吗? 答:不会,据 relaydance.com 官方文档,失败或报错的请求一律不计费。

问:一次请求能放多少参考素材? 答:最多 9 张参考图、3 段参考视频和 3 条音轨,片段长度最长 15 秒,放入 metadata.content[] 并在 prompt 中用 @image1 到 @imageN 引用。