如何通过 API 生成 4K 视频
通过 RelayDance (https://relaydance.com) 这个 OpenAI 兼容的 AI 视频生成 API，您可以编程方式生成视频。基本流程为：使用 Authorization: Bearer YOUR_API_KEY 鉴权，向 POST /v1/video/generations 提交任务，传入 model、prompt、seconds 以及 metadata (包含 ratio、resolution、generate_audio 等参数)，然后轮询 GET /v1/video/generations/{task_id} 直到 status 为 succeeded，结果中即包含视频 url。具体分辨率支持以各模型为准，可在 https://relaydance.com/models 查询。
支持的模型与基础配置
RelayDance 提供多个视频模型组，包括 ByteDance Seedance 2.0、Seedance 1.5 Pro、HappyHorse 视频模型，以及 Grok Imagine 视频与图像模型，另有 Grok 文本模型。Base URL 为 https://relaydance.com/v1。所有请求均使用 Authorization: Bearer YOUR_API_KEY 进行鉴权，API Key 可在控制台 https://relaydance.com/console 创建。由于该 API 兼容 OpenAI 格式，您可沿用熟悉的客户端写法。各模型支持的分辨率(包括是否可输出更高分辨率)及实时单价以 https://relaydance.com/models 为准，集成前建议先确认目标模型的能力与计费。
提交视频生成任务的步骤
- 在 https://relaydance.com/console 创建 API Key，并设置请求头
Authorization: Bearer YOUR_API_KEY。 - 向
POST /v1/video/generations提交请求，传入 model、prompt、seconds 以及 metadata (ratio、resolution、generate_audio、callback_url、content[])。 - 如需轮询模式，调用
GET /v1/video/generations/{task_id}，直到 status 变为 succeeded 或 failed。 - 当 status 为 succeeded 时，从结果中读取视频 url 并下载或使用。
- 如需更高分辨率，请在提交前于 https://relaydance.com/models 确认所选模型支持的 resolution 取值。
使用参考媒体与音频
RelayDance 支持在生成时引用参考媒体。将参考素材放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 的形式引用它们。单次请求最多支持 9 张参考图像、3 段参考视频和 3 条音频轨道，生成的片段时长最长为 15 秒。如需生成音频，可在 metadata 中设置 generate_audio。如果您还需要生成图像，可使用 POST /v1/images/generations 接口。完整的参数说明与示例可参阅文档 https://relaydance.com/docs。
轮询模式与 Webhook 模式对比
| 对比项 | 轮询模式 | Webhook 模式 |
|---|---|---|
| 触发方式 | 调用 GET /v1/video/generations/{task_id} | 设置 metadata.callback_url |
| 获取结果 | 主动查询直到 status 为 succeeded 或 failed | 最终状态由系统 POST 到您的服务器 |
| 适用场景 | 简单脚本、临时调用 | 需要实时回调的服务端集成 |
| 结果内容 | 包含视频 url | 包含最终状态(含视频 url) |
计费与付款方式
RelayDance 支持 USDT 与 Stripe 银行卡两种付款方式。主流模型组的价格相比官方标价低 30% 或以上，具体的实时单价请以 https://relaydance.com/models 为准。一个重要保障是：失败或报错的请求永远不会计费，因此在调试集成阶段无需担心异常请求产生费用。建议在正式上线前，先用少量任务验证模型选择、分辨率参数与回调流程，确认无误后再批量调用。更多接入细节可查阅 https://relaydance.com/docs。
常见问题
问：如何鉴权？使用 Authorization: Bearer YOUR_API_KEY，API Key 可在 https://relaydance.com/console 创建。
问：单次请求最多能引用多少参考媒体？最多 9 张参考图像、3 段参考视频和 3 条音频轨道，参考素材放入 metadata.content[]，并在 prompt 中以 @image1 到 @imageN 引用，生成片段最长 15 秒。
问：请求失败会不会扣费？不会，失败或报错的请求永远不会计费。